Update readme and installation instructions

Author: TheEdgeOfRage

README.md

@@ -1,83 +1,50 @@
-# CodeClaw
+# ClawCode
 
-Telegram interface for [OpenCode](https://opencode.ai), implemented as an OpenCode plugin.
+OpenCode plugin for exchange logging and workspace configuration (skills, agents, commands, tools).
 
 ## Prerequisites
 
 - [OpenCode](https://opencode.ai) installed
 - [Bun](https://bun.sh)
-- Telegram bot token from [@BotFather](https://t.me/BotFather)
-- Your Telegram user ID from [@userinfobot](https://t.me/userinfobot)
+- [qmd](https://github.com/qmd-project/qmd)
 
 ## Setup
 
 ```bash
 bun install
 ```
 
-Create `~/.config/opencode/clawcode.json`:
+Optionally create `~/.config/opencode/clawcode.json` to override the exchanges directory:
 
 ```json
 {
-  "token": "your-bot-token",
-  "allowedUsers": [123456789]
+  "exchangesDir": "/custom/path/to/exchanges"
 }
 ```
 
-## Install
-
-Symlink the plugin into your OpenCode workspace:
+Default: `$XDG_DATA_HOME/opencode/exchanges` (falls back to `~/.local/share/opencode/exchanges`).
 
-```bash
-mkdir -p /path/to/workspace/.opencode/plugins
-ln -s /path/to/clawcode/src/main.ts /path/to/workspace/.opencode/plugins/clawcode.ts
-```
-
-Or use the Makefile to install the systemd service, plugin, and `.opencode/` assets:
+## Install
 
 ```bash
-make install
+./install.sh install
 systemctl --user enable --now opencode-server.service
 ```
 
-The Telegram bot is **on-demand** by default. Use `/telegram connect` in the OpenCode TUI to start it. The systemd unit sets `TELEGRAM_AUTOCONNECT=1` to auto-start.
+This copies skills, agents, tools, and commands to `$OPENCODE_WORKSPACE/.opencode/`, symlinks the plugin, and installs the systemd service.
 
 To remove:
 
 ```bash
-make uninstall
+./install.sh uninstall
 ```
 
-## Bot Commands
-
-| Command | Description |
-|---|---|
-| `/new` | New session |
-| `/sessions` | List and switch sessions |
-| `/abort` | Abort current session |
-| `/history` | Recent messages from current session |
-| `/agent <name>` | Switch agent (omit name to list available) |
-| `/remember <text>` | Save a memory to MEMORY.md via OpenCode |
-| `/start_llama` | Start llama systemd service |
-| `/stop_llama` | Stop llama systemd service |
+## Exchange Logging
 
-Send any text message to prompt OpenCode. Responses stream in real-time.
-Permission requests appear as inline keyboards.
+Every completed session exchange is automatically saved as qmd-compatible markdown to the exchanges directory. The plugin listens for `session.idle` events and captures the last user/assistant message pair.
 
-## Memory System
+The install script sets up a qmd collection for semantic search. New exchanges are automatically indexed after each save.
 
-Every exchange is automatically saved to `exchanges/` as qmd-compatible markdown.
-
-- `/remember <text>` — tells OpenCode to append a memory to `MEMORY.md` in the workspace (always read on startup)
-- The `recall` skill lets the model search past exchanges via qmd on demand
-
-### qmd Setup
-
-After first run, create a qmd collection for the exchanges:
-
-```bash
-qmd collection add /path/to/exchanges --name exchanges --mask "**/*.md"
-qmd embed
-```
+## Telegram Bridge
 
-New exchanges are automatically indexed via `qmd update && qmd embed` after each save (if `qmd` is installed).
+For Telegram integration, see [opencode-telegram](https://github.com/TheEdgeOfRage/opencode-telegram).

install.sh

@@ -18,6 +18,12 @@ do_install() {
 	mkdir -p "$OPENCODE_WORKSPACE/.opencode/plugins"
 	ln -sf "$PWD/src/main.ts" "$OPENCODE_WORKSPACE/.opencode/plugins/clawcode.ts"
 
+	command -v qmd &>/dev/null || { echo "qmd is required but not installed" >&2; exit 1; }
+	EXCHANGES_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/opencode/exchanges"
+	mkdir -p "$EXCHANGES_DIR"
+	qmd collection add "$EXCHANGES_DIR" --name exchanges --mask "**/*.md" 2>/dev/null || true
+	qmd embed
+
 	mkdir -p "$SYSTEMD_DIR"
 	sed "s|{{WORKDIR}}|$OPENCODE_WORKSPACE|g" "$SERVICE" > "$SYSTEMD_DIR/$SERVICE"
 	systemctl --user daemon-reload

opencode/skills/recall/SKILL.md

@@ -25,7 +25,6 @@ qmd embed
    - For broad recall: `qmd query 'question text' --collections exchanges` (auto-expand)
 3. Review the results and extract the relevant context.
 4. Present a concise summary of what was found, with key details from the past exchanges.
-5. If `qmd` is not available or the collection doesn't exist, fall back to grep. Find the exchanges directory by running `qmd collection list` or checking `exchangesDir` in `~/.config/opencode/clawcode.json`. Do NOT assume exchanges are in the skill's own directory — they are stored separately by the Telegram bridge plugin.
 
 ## Query Examples