Module subagents

agcodex_core

Module subagents 

Source
Expand description

Subagent system for AGCodex

The subagent system enables specialized AI assistants for task-specific workflows. Each subagent operates with its own context, custom prompts, and tool permissions.

§Key Features

  • Specialized Agents: Code review, refactoring, debugging, testing, etc.
  • Mode Override: Agents can override operating mode (Plan/Build/Review)
  • Template System: Reusable agent configurations
  • Hot Reload: Dynamic loading of agent configurations
  • Chaining & Parallel: Sequential (→) or parallel (+) execution

§Usage

@agent-code-reviewer - Review code for quality and security
@agent-refactorer → @agent-test-writer - Chain agents sequentially
@agent-performance + @agent-security - Run agents in parallel

§Configuration

Agents are configured via TOML files in:

  • ~/.agcodex/agents/global/ - Available everywhere
  • ./.agcodex/agents/ - Project-specific agents
  • templates/ - Reusable templates

Re-exports§

pub use agents::AgentRegistry;
pub use agents::AgentResult;
pub use agents::AgentStatus;
pub use agents::CodeReviewerAgent;
pub use agents::DebuggerAgent;
pub use agents::DocsAgent;
pub use agents::Finding;
pub use agents::PerformanceAgent;
pub use agents::RefactorerAgent;
pub use agents::SecurityAgent;
pub use agents::Severity;
pub use agents::Subagent;
pub use agents::TestWriterAgent;
pub use built_in::create_default_registry;
pub use built_in::register_built_in_agents;
pub use config::IntelligenceLevel;
pub use config::SubagentConfig;
pub use config::ToolPermission;
pub use context::AgentContext;
pub use context::AgentContextSnapshot;
pub use context::AgentMessage;
pub use context::CancellationToken;
pub use context::ContextError;
pub use context::ContextFinding;
pub use context::ContextResult;
pub use context::ExecutionMetricsSnapshot;
pub use context::FindingSeverity;
pub use context::MessagePriority;
pub use context::MessageReceiver;
pub use context::MessageTarget;
pub use context::MessageType;
pub use context::ProgressEvent;
pub use context::ProgressInfo;
pub use context::ProgressStage;
pub use context::ProgressTracker;
pub use invocation::AgentChain;
pub use invocation::AgentInvocation;
pub use invocation::ExecutionPlan;
pub use invocation::ExecutionStep;
pub use invocation::InvocationParser;
pub use invocation::InvocationRequest;
pub use manager::AgentHandle;
pub use manager::AgentManager;
pub use manager::AgentStats;
pub use manager::MessageBus;
pub use mcp_tools::McpAgentHandler;
pub use mcp_tools::McpAgentTool;
pub use mcp_tools::McpAgentToolProvider;
pub use orchestrator::AgentOrchestrator;
pub use orchestrator::ContextSnapshot;
pub use orchestrator::OrchestratorConfig;
pub use orchestrator::OrchestratorResult;
pub use orchestrator::ProgressUpdate;
pub use orchestrator::SharedContext;
pub use parser::AgentParser;
pub use parser::ChainOperator;
pub use parser::ParsedInvocation;
pub use registry::SubagentRegistry;
pub use registry::SubagentRegistryError;
pub use worktree::AgentWorktree;
pub use worktree::ConflictStrategy;
pub use worktree::MergeResult;
pub use worktree::WorktreeManager;
pub use worktree::WorktreePool;

Modules§

agents
Core subagent implementations for AGCodex
built_in
Built-in subagents for AGCodex
config
Configuration structures for subagents
context
Execution context and progress tracking for AGCodex agents
invocation
Agent invocation parsing and execution planning
manager
Agent Manager for spawning and coordinating subagents
mcp_tools
MCP tool definitions and integration for AGCodex subagents
orchestrator
Agent orchestration engine for managing and coordinating subagent execution
parser
Parser module for agent invocations
registry
Subagent registry for loading and managing agent configurations
worktree
Git worktree management for parallel agent execution

Structs§

SubagentContext
Context passed to subagents during execution
SubagentExecution
Result of a subagent execution

Enums§

SubagentError
Errors that can occur in the subagent system
SubagentStatus
Status of a subagent execution

Type Aliases§

SubagentResult
Result type for subagent operations