lkn
/
ollie
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Move 'What you can do' below Configuration

This commit is contained in:
Ollie Agent 2026-08-05 19:11:22 +02:00
parent 0b9d5a9124
commit 6e4a14de2d
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
README.md
View File

@ -46,6 +46,24 @@ OLLIE_ROUTE_MODEL=qwen3:8b # model for task routing
Shell environment variables take precedence over the env file.
## What you can do
| Capability | How |
|---|---|
| **Run an agent** | `olliesrv` → any frontend ([ellie](doc/ellie.md), KDE, acme, `o tui`) |
| **Terminal TUI** | `o tui` — tmux + two shell commands, no widgets |
| **Remote execution** | Set `remote=user@host` in session config |
| **Multi-agent** | `subagent_spawn` from within a session, or shell scripts |
| **Code completion** | Read/write `/complete` for fill-in-the-middle |
| **One-shot LLM** | Write to `/generate`, read back the response |
| **Task routing** | Write to `/route`, read back `backend=X model=Y` |
| **Background jobs** | Detach via `shell({"elevated":true, "detach":true})` |
| **Load tools** | Write tool name to `agent/{aname}/tools` via 9P |
| **Custom tools** | Drop an executable + `.meta` in `$OLLIE_TOOLS_PATH` |
| **Privileged tools** | Declare `"sudo": true` in `.meta` — broker handles elevation + credentials |
| **Custom agents** | Write a JSON config in `agents/` |
| **Domain skills** | Write a markdown file in `skills/` |
## Repository layout
Single Go module with one Git submodule (kde).
@ -118,24 +136,6 @@ graph TB
KDE GUI, Kate plugin, and KRunner all use 9P internally. For a deep dive into the
filesystem, see [`doc/resources/9p.md`](doc/resources/9p.md).
## What you can do
| Capability | How |
|---|---|
| **Run an agent** | `olliesrv` → any frontend ([ellie](doc/ellie.md), KDE, acme, `o tui`) |
| **Terminal TUI** | `o tui` — tmux + two shell commands, no widgets |
| **Remote execution** | Set `remote=user@host` in session config |
| **Multi-agent** | `subagent_spawn` from within a session, or shell scripts |
| **Code completion** | Read/write `/complete` for fill-in-the-middle |
| **One-shot LLM** | Write to `/generate`, read back the response |
| **Task routing** | Write to `/route`, read back `backend=X model=Y` |
| **Background jobs** | Detach via `shell({"elevated":true, "detach":true})` |
| **Load tools** | Write tool name to `agent/{aname}/tools` via 9P |
| **Custom tools** | Drop an executable + `.meta` in `$OLLIE_TOOLS_PATH` |
| **Privileged tools** | Declare `"sudo": true` in `.meta` — broker handles elevation + credentials |
| **Custom agents** | Write a JSON config in `agents/` |
| **Domain skills** | Write a markdown file in `skills/` |
## Credits
- [Plan 9 from Bell Labs](https://9fans.net) — for an interesting system