A full-screen TUI CLI agent powered by local LLMs via Docker Model Runner
paikea docs reference tools.md
2.8 kB · 64 lines
Markdown
at main

# Built-in tools During a turn the model can call tools; paikea executes them and feeds the result back into the conversation. Read-only tools run immediately; destructive tools require confirmation. ## Bundled tools | Tool | Parameters | Destructive | Description | |------|-----------|:-----------:|-------------| | `web_search` | `query` | no | Search the web via DuckDuckGo; returns titles, URLs, snippets | | `get_webpage` | `url` | no | Fetch a page and return its text content | | `read_skill` | `name` | no | Load a skill's full instructions on demand by name | | `read_file` | `path` | no | Read a file (relative to the project root) | | `list_files` | `path` | no | List files and directories at a path | | `write_file` | `path`, `content` | **yes** | Create or overwrite a file | | `shell_exec` | `command` | **yes** | Run a shell command in the project directory | | `git_propose` | — | no | Create a `feat/<name>` branch for the latest OpenSpec change | | `git_commit` | `message` | no | Stage all changes and commit (conventional-commits + gitmoji format) | | `git_archive` | — | no | Archive the OpenSpec change, commit the result, and merge the feature branch into `main` (pushing to origin when one exists) | `read_skill` pairs with the skills manifest in the system prompt: the prompt lists skills by name and description, and the model calls `read_skill` to pull a skill's full text only when it needs it. The three `git_*` tools are orchestrated by the `openspec-git` skill, which the per-step guidance triggers automatically: `git_propose` at the **proposal** step, `git_commit` after each finished task in **apply**, and `git_archive` at **archive**. See [Drive the OpenSpec workflow](../how-to/drive-the-workflow.md). ## Custom tools Tools are loaded from three sources, later ones overriding earlier ones by name: 1. **Bundled** — compiled into the binary (the table above) 2. **User-global** — `~/.config/paikea/tools/*.tool.json` 3. **Project** — `.paikea/tools/*.tool.json` A `*.tool.json` file defines one tool:…