rethink-software/claudedo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: lead how-to-run with the terminal-run model

Browse Source 
state terminal-run as the product (the claudedo start terminal is the
recognition/action console) and frame backgrounding/autostart/systemd as
optional extras, not the default.

Signed-off-by: disqualifier <dev@disqualifier.me>
This commit is contained in:
disqualifier 2026-06-25 18:42:22 -04:00
parent 7f4a6f6699
commit 66b08d290c
1 changed files with 8 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
README.md
View File

@ -61,6 +61,12 @@ claudedo test-audio
## Usage
**Run it in a terminal you watch** — that's the product. The `claudedo start`
terminal is your recognition/action console (it logs what it heard, what it matched,
and what it injected); you attach to the `claude-<name>` session in another pane to
watch the keystrokes land. Backgrounding (tmux/autostart/systemd, below) is an
optional extra, not the default — it hides the console you'd otherwise read.
```bash
claudedo start # run the daemon (foreground; listen mode by default)
claudedo start --mode ptt # push-to-talk instead (desk-only — see Modes)
@ -70,7 +76,8 @@ claudedo switch <name> # retarget to claude-<name>
claudedo test-audio # verify the mic capture path
```
Background it in its own tmux session:
If you do want it backgrounded (optional — you lose the live console), run it in its
own tmux session:
```bash
tmux new-session -d -s claudedo 'claudedo start'