Crate aegis_tools 

aegis-tools

Built-in tool implementations for the Aegis agent.

Provides the core tools that every Aegis agent has access to:

• ReadFileTool / WriteFileTool: filesystem operations
• SearchFilesTool: grep-based code search
• PatchTool: apply unified diffs
• TerminalTool: shell command execution (with security checks)
• SessionSearchTool: search past conversations
• MemorySearchTool: search agent memory by keyword
• RecordSearchTool: search conversation records
• BrowserTool: web browsing via bridge
• TodoTool: task list management
• SpawnTaskTool: create background tasks

Tools implement the Tool trait and register into ToolRegistry.

Re-exports

pub use memory_search::MemorySearchTool;

pub use record_search::RecordSearchTool;

pub use crates_io::CratesTool;

pub use skill::SkillTool;

pub use remote::RemoteTool;

pub use selfmod::SelfModTool;

pub use session_tool::SessionTool;

pub use control_tool::ControlTool;

pub use control_tool::AgentControl;

pub use control_tool::execute_agent_command;

pub use control_tool::CMD_PREFIX;

pub use widget::WidgetTool;

pub use widget::load_widgets;

pub use widget::render_widget_lines;

Modules

background

batch

control_tool

crates_io

crates tool — read-only queries against the Rust package ecosystem.

delegation

memory_search

output_buffer

peers

A2A peer registry — other aegis instances this agent can delegate to.

record_search

remote

Remote server access over SSH (stage 1 of multi-machine support).

remotes

Named remote-server credentials (“credential vault” by handle).

selfmod

selfmod tool — unified entry point for aegis self-modification.

session_tool

skill

skill tool — on-demand skill discovery for scale (M-S2b).

widget

Structs

BackgroundTool

Run and supervise long-running processes without blocking the agent loop. Output is redirected to a per-task log file (so the pipe never fills and blocks), which the agent tails via the logs action.

BrowserTool

CheckpointManager

ClarifyTool

MaigretTool

PatchTool

ReadFileTool

SearchFilesTool

SessionSearchTool

SpawnTaskTool

TerminalTool

TodoTool

ToolContext

Context passed to every tool execution.

ToolRegistry

Registry of available tools.

WebExtractTool

WebSearchTool

WriteFileTool

Enums

BgBackend

Backend for the background tool. Auto uses tmux when available (giving tasks an independent lifetime + tmux attach re-attachability), else falls back to a detached child process.

Traits

Tool

A tool that the agent can invoke.

Functions

read_todo_progress

Summarize the session’s todo list as (completed, total, current_item), where current_item is the first not-yet-done task. Returns None when there are no tasks. Used by the CLI to render a live progress bar.

todo_path

Path to the session’s todo file (~/.aegis/todos/<session>.txt).