Skip to content

Latest commit

 

History

History
99 lines (73 loc) · 2.29 KB

README.md

File metadata and controls

99 lines (73 loc) · 2.29 KB

TurboClaude Agent Framework

Agent framework built on TurboClaude for creating AI agents with message hooks, permissions, routing, and skill integration.

Documentation

Features

  • Agent client with routing and message parsing
  • Message hooks for interception and modification
  • Permission system for capability control
  • Skills integration and execution
  • Message routing and filtering
  • Session management

Quick Start

use turboclaudeagent::Agent;
use turboclaude::types::MessageRequest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
 let agent = Agent::builder()
 .api_key("sk-ant-...")
 .name("MyAgent")
 .build()?;

 let response = agent.query("What is 2+2?").await?;
 println!("{}", response);

 Ok(())
}

Components

Agent Client

Main entry point for agent interactions with configurable behavior.

Hooks

Intercept and modify:

  • message_start: Before sending messages
  • message_stop: After receiving messages
  • tool_call: Before executing tools
  • tool_result: After tool execution

Permissions

Control agent capabilities:

  • Tool execution permissions
  • Resource access control
  • Rate limiting

Skills

Dynamic skill registration and execution:

  • Register skills from external systems
  • Execute skills based on agent needs
  • Manage skill lifecycle

Architecture

turboclaudeagent
├── client (Agent client implementation)
├── config (Configuration builder)
├── hooks (Extensible hook system)
├── permissions (Permission control)
├── routing (Message routing logic)
├── skills (Skills integration)
└── message_parser (Advanced message parsing)

Examples

See examples/ for:

  • simple_query.rs - Basic agent usage
  • with_hooks.rs - Hook system demonstration
  • with_permissions.rs - Permission configuration
  • with_skills.rs - Skills integration

Testing

cargo test --all

See tests/ for comprehensive test coverage including E2E tests.

Documentation

Full documentation: cargo doc --open

Part of TurboClaude