initial commit

2026-07-12 10:17:17 -04:00
commit dab5a4ebc6
1424 changed files with 330463 additions and 0 deletions
@@ -0,0 +1,73 @@
+# OpenCode CLI — Detailed Integration Guide
+
+[OpenCode](https://opencode.ai) is a provider-agnostic, open-source AI coding agent. This reference covers binary resolution, session management, and key pitfalls.
+
+## Binary Resolution
+
+Shell environments may resolve different OpenCode binaries. Check:
+
+```bash
+terminal(command="which -a opencode")
+terminal(command="opencode --version")
+```
+
+If needed, pin an explicit binary path: `$HOME/.opencode/bin/opencode run '...'`
+
+## Interactive Sessions (Background)
+
+```bash
+# Start TUI in background
+terminal(command="opencode", workdir="~/project", background=true, pty=true)
+
+# Send a prompt
+process(action="submit", session_id="<id>", data="Implement OAuth refresh flow")
+
+# Monitor
+process(action="log", session_id="<id>")
+
+# Exit — use Ctrl+C, NOT /exit
+process(action="write", session_id="<id>", data="\x03")
+```
+
+**Important:** Do NOT use `/exit` — it opens an agent selector instead. Use Ctrl+C (`\x03`) or `process(action="kill")`.
+
+## TUI Keybindings
+
+| Key | Action |
+|-----|--------|
+| Enter | Submit message |
+| Tab | Switch between agents |
+| Ctrl+P | Command palette |
+| Ctrl+X L | Switch session |
+| Ctrl+X M | Switch model |
+| Ctrl+X N | New session |
+| Ctrl+C | Exit |
+
+## PR Review
+
+```bash
+terminal(command="opencode pr 42", workdir="~/project", pty=true)
+```
+
+Or review in a temporary clone for isolation.
+
+## Session & Cost Management
+
+```bash
+opencode session list
+opencode stats
+opencode stats --days 7 --models anthropic/claude-sonnet-4
+```
+
+## Common Flags
+
+| Flag | Use |
+|------|-----|
+| `run 'prompt'` | One-shot execution and exit |
+| `-c` / `--continue` | Continue last session |
+| `-s <id>` | Continue a specific session |
+| `--agent <name>` | Choose agent (build or plan) |
+| `--model provider/model` | Force specific model |
+| `--thinking` | Show model thinking blocks |
+| `--format json` | Machine-readable output |
+| `-f <path>` | Attach file(s) to the message |