Files

T

justsisyphus f1393d3e85 docs: regenerate hierarchical AGENTS.md with deep investigation

- Root: 181 lines with agent models, complexity hotspots, CI pipeline
- Hooks: 31 lifecycle hooks, execution order, patterns
- Tools: 20+ tools, LSP/AST-Grep specifics, registration
- Features: Background agents, Claude Code compat, skill MCP
- Agents: 10 agents with models, tool restrictions
- Shared: 43 utilities with usage patterns
- CLI: Commander.js entry, doctor checks, TUI framework

Generated via /init-deep with 12 parallel explore agents

2026-01-17 22:01:56 +09:00

2.9 KiB

Raw Blame History

TOOLS KNOWLEDGE BASE

OVERVIEW

20+ tools: LSP (11), AST-Grep (2), Search (2), Session (4), Agent delegation (3), System (2). High-performance C++ bindings via @ast-grep/napi.

STRUCTURE

tools/
├── [tool-name]/
│   ├── index.ts      # Barrel export
│   ├── tools.ts      # Business logic, ToolDefinition
│   ├── types.ts      # Zod schemas
│   └── constants.ts  # Fixed values, descriptions
├── lsp/              # 11 tools: goto_definition, references, symbols, diagnostics, rename
├── ast-grep/         # 2 tools: search, replace (25 languages via NAPI)
├── delegate-task/    # Category-based agent routing (761 lines)
├── session-manager/  # 4 tools: list, read, search, info
├── grep/             # Custom grep with timeout/truncation
├── glob/             # Custom glob with 60s timeout, 100 file limit
├── interactive-bash/ # Tmux session management
├── look-at/          # Multimodal PDF/image analysis
├── skill/            # Skill execution
├── skill-mcp/        # Skill MCP operations
├── slashcommand/     # Slash command dispatch
├── call-omo-agent/   # Direct agent invocation
└── background-task/  # background_output, background_cancel

TOOL CATEGORIES

Category	Tools	Purpose
LSP	lsp_goto_definition, lsp_find_references, lsp_symbols, lsp_diagnostics, lsp_prepare_rename, lsp_rename	Semantic code intelligence
Search	ast_grep_search, ast_grep_replace, grep, glob	Pattern discovery
Session	session_list, session_read, session_search, session_info	History navigation
Agent	delegate_task, call_omo_agent, background_output, background_cancel	Task orchestration
System	interactive_bash, look_at	CLI, multimodal
Skill	skill, skill_mcp, slashcommand	Skill execution

HOW TO ADD

Create src/tools/[name]/ with standard files

Use tool() from @opencode-ai/plugin/tool:

export const myTool: ToolDefinition = tool({
  description: "...",
  args: { param: tool.schema.string() },
  execute: async (args) => { /* ... */ }
})

Export from src/tools/index.ts
Add to builtinTools object

LSP SPECIFICS

Client: client.ts manages stdio lifecycle, JSON-RPC
Singleton: LSPServerManager with ref counting
Protocol: Standard LSP methods mapped to tool responses
Capabilities: definition, references, symbols, diagnostics, rename

AST-GREP SPECIFICS

Engine: @ast-grep/napi for 25+ languages
Patterns: Meta-variables $VAR (single), $$$ (multiple)
Performance: Rust/C++ layer for structural matching

ANTI-PATTERNS

Sequential bash: Use && or delegation, not loops
Raw file ops: Never mkdir/touch in tool logic
Sleep: Use polling loops, tool-specific wait flags
Heavy sync: Keep PreToolUse light, computation in tools.ts

2.9 KiB Raw Blame History