Repository navigation
v0.11.0
Chat tools grow from two read-only builtins to seven, all compiled into ahi and governed by ahi.tools.yaml. See Tool catalog for the survey behind the design and Chat screen for the contract.
Added
find_filesandsearch_files(action: tool_call): glob over names or paths, and regex or literal search returningpath:line:text. In process with norg,fd, orgitsubprocess;.gitignorehonored; symbolic links never followed; sorted, capped output. The walk is a parallel structure-of-arrays arena; search uses three syscalls per file. (#41)read_filepaging:offsetandlimit; at the 64 KiB cap the tail names the offset to continue from and no partial line is emitted. Whole files come back verbatim. (#41)edit_fileandwrite_file(action: file_write): replace text that occurs exactly once (or every occurrence withreplace_all), and create a file (or replace one withoverwrite). A rule namesedit_file,write_file, or neither for both, so creating and editing are approved separately. Atomic writes, confined to the working directory, never through a symlink;ahi.tools.yaml,ahi.hooks.yaml,ahi.dev.yaml,.pre-commit-config.yaml,.gitignore, and.gitare never writable. The prompt shows line counts, never text. Hash-only audit line per attempt. (#42)run_command(action: command): argv list, no shell, matched bymatch.argvas a token-by-token prefix with optionalmatch.pathfor the working directory andtoolchain_envas inahi.hooks.yaml. Scrubbed environment plusAHI_TOOL=run_command, timeout (default 120 s, max 600), stdout and stderr capped at 32 KiB each. The prompt shows the command line; a session grant is the asking rule's argv prefix. Output-free audit line per attempt. Host execution in this alpha;ahi dev run -- ahi tuiis the container boundary untilahi sandbox run. (#43)ahi devandahi dev runset the container hostname to the image's short name. (#38)docs/TOOL_CATALOG.md: built-in tools, output bounds, permission grammars, and confinement across pi, Claude Code, Codex CLI, OpenCode, Gemini CLI, Aider, Goose, Amp, Cline, and Roo Code. (#40)
Examples
examples/tools/edit-sources.yaml and examples/tools/commands.yaml show the new rule kinds. The repository's own ahi.tools.yaml approves the four read tools.