From 6e4a14de2d3290b043cc1b59c75b6fcc6aeef20e Mon Sep 17 00:00:00 2001 From: Ollie Agent Date: Wed, 5 Aug 2026 19:11:22 +0200 Subject: [PATCH] Move 'What you can do' below Configuration --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 947e2d6..d6c31bd 100644 --- a/README.md +++ b/README.md @@ -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