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

docs: update README, help.md with current filesystem, fix D-Bus examples

This commit is contained in:
Ollie Agent 2026-07-21 14:51:18 +02:00
parent 5e5cd8e689
commit cca4410b25
2 changed files with 20 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
9p

@ -1 +1 @@
Subproject commit c289f5c7fd55201787e5e5d314ba4613d77d3741
Subproject commit 4a87d25f227025601cc9ddfda994acd6c9cd239e

29
README.md
View File

@ -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: