#Tools Reference

CodeCLI includes 150+ built-in tools spanning file operations, shell execution, web access, GUI automation, multi-agent orchestration, and integrations with external services. Tools are invoked by the AI agent automatically based on the task. Each tool has defined parameters with JSON Schema validation.

#Core Tools

Fundamental tools for file and shell operations. These are the most frequently used tools.

#bash

Execute a shell command. The command runs in the working directory with full shell expansion. Supports pipes, redirects, and environment variables.

{ "command": "npm test -- --coverage", "timeout": 30000 }

#read

Read file contents. Supports reading specific line ranges and images (PNG, JPG). For large files, use offset and limit parameters.

{ "file_path": "/home/user/project/src/index.ts", "offset": 10, "limit": 50 }

#write

Create a new file or completely replace an existing file with the given content. Use edit for targeted modifications.

{ "file_path": "/home/user/project/config.json", "content": "{\n  \"port\": 3000\n}" }

#edit

Edit an existing file by replacing an exact string match. The old_string must be unique in the file. Supports replace_all for renaming across a file.

{ "file_path": "/home/user/project/src/app.ts", "old_string": "const PORT = 3000;", "new_string": "const PORT = 8080;" }

#glob

Find files matching a glob pattern. Returns file paths sorted by modification time.

{ "pattern": "**/*.test.ts", "path": "/home/user/project" }

#grep

Search file contents using ripgrep (regex). Supports multiple output modes and file type filtering.

{ "pattern": "TODO|FIXME", "path": "/home/user/project/src", "output_mode": "content", "-n": true }

#list

List directory contents. Equivalent to ls, showing files and directories.

{ "path": "/home/user/project/src" }

#Web Tools

Tools for fetching and searching web content.

#webfetch

Fetch and parse a web page. Returns the page content as markdown or plain text. Supports timeout and image retention options.

{ "url": "https://docs.example.com/api", "return_format": "markdown" }

#websearch

Search the web and return results with titles, descriptions, and URLs. Supports domain filtering.

{ "query": "Rust Axum middleware guide 2026", "allowed_domains": ["docs.rs", "tokio.rs"] }

#codesearch

Search public code repositories for specific patterns. Returns matching code snippets with repository context.

{ "query": "Axum router with state", "language": "rust" }

#Task Tools

Tools for agent orchestration and skill invocation.

#task

Spawn a subagent to handle a specific subtask. The subagent runs independently with its own context window and can use the full set of available tools.

{ "description": "Write unit tests for src/auth/*.ts", "agent": "test-writer" }

#skill

Load a specialized skill (slash command) that provides domain-specific instructions and tools to the current agent.

{ "skill": "commit", "args": "-m 'Fix auth token refresh'" }

#Computer Use

GUI automation tool for desktop interaction. Supports 10 actions.

#computer_use

Interact with the desktop environment. Supports screenshots, mouse, keyboard, and window management.

{ "action": "click", "x": 500, "y": 300 }
{ "action": "type", "text": "Hello World" }
{ "action": "key", "keys": "ctrl+s" }
{ "action": "window_list" }

#Development Tools

Advanced development tool suites from Lgrep and Thoth.

#Lgrep Tools (8 tools)

Lgrep provides structural code analysis tools for understanding and navigating codebases.

{ "tool": "lgrep_symbols", "file_path": "/home/user/project/src/auth.ts", "symbol_type": "function" }

#Thoth Tools (3 tools)

Thoth provides documentation and knowledge base tools for generating and querying docs.

{ "tool": "thoth_query", "query": "How does authentication work?", "top_k": 5 }

#Integration Tools

Tools for integrating with external services and platforms.

#Obsidian Tools (10+ tools)

Read, write, and manage notes in an Obsidian vault.

{ "tool": "obsidian_search", "query": "project roadmap", "vault": "personal", "limit": 10 }

#GitHub Tools (7 tools)

Interact with GitHub repositories, issues, and pull requests.

{ "tool": "github_pr", "owner": "poly", "repo": "backend", "action": "list", "state": "open" }

#Mainframe Tools (9 tools)

Control multi-terminal agent sessions in mainframe mode.

{ "tool": "mainframe_spawn", "agent": "coder", "model": "claude-sonnet-4-20250514", "prompt": "Fix the failing tests" }

#Swarm Tools (6 tools)

Orchestrate multi-agent swarm execution.

{ "tool": "swarm_init", "task": "Add tests for all API endpoints", "max_agents": 4, "model": "claude-sonnet-4-20250514" }

#Mercury Tools (4 tools)

Cognitive memory layer for persistent knowledge across sessions.

{ "tool": "mercury_recall", "query": "project architecture decisions", "limit": 5 }

#RAG Tools (3 tools)

Retrieval-Augmented Generation for querying document collections.

{ "tool": "rag_query", "query": "How is authentication implemented?", "top_k": 5 }

#Reason Tools (3 tools)

Structured reasoning and analysis tools.

{ "tool": "reason_decompose", "task": "Migrate from REST to GraphQL", "strategy": "incremental" }

#Story Tools (3 tools)

Story and requirements management tools.

{ "tool": "story_create", "title": "Add 2FA support", "description": "Users should be able to enable TOTP-based 2FA", "priority": "high" }

#Dataset Tools (3 tools)

Manage datasets for training, evaluation, and RAG.

{ "tool": "dataset_create", "name": "api-docs", "source": "./docs/api", "format": "jsonl" }

#Session Tools

Tools for managing task state within a session.

#todowrite

Create or update the task list for the current session. Replaces the entire todo list.

{ "todos": [
  { "id": "1", "content": "Fix auth bug", "status": "in_progress", "priority": "high" },
  { "id": "2", "content": "Write tests", "status": "pending", "priority": "medium" },
  { "id": "3", "content": "Update docs", "status": "completed", "priority": "low" }
] }

#todoread

Read the current task list.

{ }

#kanbanwrite

Create or update the kanban board. Supports columns, cards, priorities, and swim lanes.

{ "board": {
  "columns": ["Backlog", "In Progress", "Review", "Done"],
  "cards": [
    { "id": "c1", "title": "Fix login bug", "column": "In Progress", "priority": "high" },
    { "id": "c2", "title": "Add tests", "column": "Backlog", "priority": "medium" }
  ]
} }

#kanbanread

Read the current kanban board state.

{ }

#session_memory

Store and retrieve session-specific memory. Persists across turns within a session.

{ "action": "store", "key": "project_stack", "value": "Next.js 16 + Rust/Axum" }

#Other Tools

#python_sandbox

Execute Python code in an isolated sandbox environment. Useful for data analysis, calculations, and scripting.

{ "code": "import json\nprint(json.dumps({'result': 42}))" }

#image

Read and analyze image files. Supports PNG, JPG, JPEG, WebP, and GIF.

{ "file_path": "/home/user/screenshot.png", "prompt": "Describe the UI layout" }

#clipboard

Read from or write to the system clipboard.

{ "action": "write", "content": "Hello, clipboard!" }

#network

Network diagnostic tools: ping, DNS lookup, and HTTP requests.

{ "action": "http", "target": "https://api.example.com/health", "options": { "method": "GET" } }

#time

Get the current date and time in various formats and timezones.

{ "format": "iso", "timezone": "America/New_York" }

#monitor

Monitor system resources: CPU, memory, disk, and process information.

{ "resource": "memory", "interval": 2 }