Something went wrong. Try again.
A full-screen TUI CLI agent powered by local LLMs via Docker Model Runner
Something went wrong. Try again.
# 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:…