name: toji
description: Graph-based code memory, FTS5 search, session compaction, and specialized child agents for the pi coding agent. Use to index codebases, explore blast radius, search symbols/files, manage coding standards, and delegate focused work.
Toji — Project Memory & Specialized Agents
Toji provides graph-based code memory, FTS5 search, session compaction, and inspectable child agents for the pi coding agent.
Commands
Project Setup
| Command |
Description |
toji_index_project |
Index the current project into Toji's SQLite/FTS5/graph memory. Run once per project or after significant changes. Returns project ID and counts. |
Project Overview
| Command |
Description |
toji_project_overview |
Get project stats: files, symbols, imports, calls, edge counts, language breakdown, directory tree, test files, and top symbols grouped by file. |
Search & Query
| Command |
Description |
toji_query_memory |
FTS5 full-text search across symbols, files, and standards. query: search terms. kind: symbols, files, standards, or all (default). |
Graph Exploration
| Command |
Description |
toji_graph_explore |
Natural-language blast-radius exploration. intent: what you want to know. seedQueries: concrete terms to seed traversal. depth: how deep to traverse (default 2). direction: incoming, outgoing, or both. |
toji_blast_radius |
Find impacted files and symbols by traversing the call graph from a target symbol. target: symbol name. filePath: optional to disambiguate. depth: traversal depth (default 2). edgeTypes: filter by edge type (e.g., symbol_calls_symbol). |
Coding Standards
| Command |
Description |
toji_add_standard |
Persist a coding standard. scope: global or project. rule: the standard text. Optional: language, framework, rationale, priority. |
toji_get_standards |
Retrieve applicable coding standards. Optional: language, framework filters. |
Specialized Child Agents
| Command |
Description |
toji_agent |
Fork the current Pi session and delegate a concrete task to doran, oner, faker, peyz, or keria. Streams child activity and returns the child's final message. |
Usage Patterns
First-Time Project Setup
toji_index_project → toji_project_overview
Finding What to Change
toji_graph_explore(intent="add a CLI adapter like hermes", seedQueries=["hermes", "adapter", "registry", "cli"])
Blast Radius Before Edit
toji_blast_radius(target="parseConfig", depth=2)
Search the Codebase
toji_query_memory(query="auth middleware", kind="symbols")
Delegate Focused Work
toji_agent(agent="oner", task="Scout the authentication flow and identify its entry points.")
toji_agent(agent="doran", task="Validate the backend change and run focused tests.")
toji_agent(agent="faker", task="Create a strict implementation plan for multi-tenant billing.")
Tool Parameters
| Parameter |
Type |
Default |
rootPath / projectPath |
string |
current pi cwd |
projectId |
string |
current indexed project |
query |
string |
— |
kind |
symbols | files | standards | all |
all |
intent |
string |
— |
seedQueries |
string[] |
— |
depth |
number |
2 |
direction |
incoming | outgoing | both |
both |
target |
string |
— |
filePath |
string |
— |
edgeTypes |
string[] |
— |
scope |
global | project |
— |
language |
string |
— |
framework |
string |
— |
rule |
string |
— |
agent |
doran | oner | faker | peyz | keria |
— |
task |
string |
— |