From cca4410b254152a6c2d6831bbadc514a8b8408d2 Mon Sep 17 00:00:00 2001 From: Ollie Agent Date: Tue, 21 Jul 2026 14:51:18 +0200 Subject: [PATCH] docs: update README, help.md with current filesystem, fix D-Bus examples --- 9p | 2 +- README.md | 29 +++++++++++++++++++---------- 2 files changed, 20 insertions(+), 11 deletions(-) diff --git a/9p b/9p index c289f5c..4a87d25 160000 --- a/9p +++ b/9p @@ -1 +1 @@ -Subproject commit c289f5c7fd55201787e5e5d314ba4613d77d3741 +Subproject commit 4a87d25f227025601cc9ddfda994acd6c9cd239e diff --git a/README.md b/README.md index dae17e4..5310f90 100644 --- a/README.md +++ b/README.md @@ -294,27 +294,29 @@ D-Bus gives you introspectable, typed interfaces with proper error returns. No s ```sh # Create a session -dbus-send --session --dest=de.lneely.ollie --print-reply \ - /de/lneely/ollie de.lneely.ollie.Manager.CreateSession \ - string:"worker" string:"" string:"" +dbus-send --session --dest=org.ollie.SessionManager --type=method_call --print-reply \ + /org/ollie/SessionManager org.ollie.SessionManager.CreateSession \ + string:"$PWD" string:"" string:"" string:"default" string:"" # Submit a prompt -dbus-send --session --dest=de.lneely.ollie --print-reply \ - /de/lneely/ollie/sessions/worker de.lneely.ollie.Session.SubmitPrompt \ - string:"fix the bug in main.go" +dbus-send --session --dest=org.ollie.SessionManager --type=method_call \ + /org/ollie/SessionManager org.ollie.SessionManager.Submit \ + string:"SESSION_ID" string:"fix the bug in main.go" # Read state -dbus-send --session --dest=de.lneely.ollie --print-reply \ - /de/lneely/ollie/sessions/worker de.lneely.ollie.Session.GetState +dbus-send --session --dest=org.ollie.SessionManager --type=method_call --print-reply \ + /org/ollie/SessionManager org.ollie.SessionManager.GetState \ + string:"SESSION_ID" ``` ### Real-time signals D-Bus signals push events to subscribers without polling: -- **`ChatDelta`** — stream tokens as they arrive +- **`ChatUpdated`** — new chat output (session_id, offset, text) - **`StateChanged`** — transition notifications (`idle` → `thinking` → `calling: grep` → `idle`) -- **`SessionCreated` / `SessionRemoved`** — lifecycle events for UIs that display session lists +- **`SessionCreated` / `SessionKilled` / `SessionRenamed`** — lifecycle events for UIs +- **`ProcessDetached` / `ProcessExited`** — background process events GUI frontends subscribe once and react to changes — no timers, no file watches, no busy loops. @@ -330,6 +332,13 @@ The D-Bus interface is what makes native desktop integration possible: All of these talk to `org.ollie.SessionManager` over D-Bus using Qt's native bindings — no IPC glue code, no subprocess management. +### Tool documentation lookup + +```sh +# Query a tool's full prompt/documentation +exec 3<>/mnt/ollie/tools; echo 'file_edit' >&3; cat <&3; exec 3>&- +``` + ## Credits Many sources of inspiration: