| 1 | # CodeWhale for VS Code |
| 2 | |
| 3 | Official Codewhale extension scaffold for local development. |
| 4 | |
| 5 | This first slice is intentionally small: |
| 6 | |
| 7 | - open Codewhale in an integrated terminal |
| 8 | - start `codewhale serve --http` in a visible terminal |
| 9 | - check a local runtime through `/health` and `/v1/runtime/info` |
| 10 | - show connection state in the status bar |
| 11 | - show a read-only Agent View with recent runtime thread summaries from |
| 12 | `/v1/threads/summary` |
| 13 | - show recent read-only restore points from `/v1/snapshots` |
| 14 | - refresh the read-only Agent View automatically so branch/workspace metadata |
| 15 | catches up while agents are working |
| 16 | |
| 17 | It does not expose the full chat webview, VS Code Agent View chat/editor |
| 18 | integration, inline edit application, marketplace publish workflow, or |
| 19 | retry/undo/snapshot GUI endpoints yet. |
| 20 | |
| 21 | ## Local Use |
| 22 | |
| 23 | ```bash |
| 24 | npm install |
| 25 | npm run compile |
| 26 | npm run package |
| 27 | code --install-extension codewhale-vscode-0.8.53.vsix |
| 28 | ``` |
| 29 | |
| 30 | Configure `codewhale.commandPath`, `codewhale.runtimeHost`, |
| 31 | `codewhale.runtimePort`, `codewhale.runtimeToken`, and |
| 32 | `codewhale.agentViewRefreshIntervalSeconds` from VS Code settings. |
| 33 | Set the refresh interval to `0` to disable automatic read-only refreshes. |
| 34 | |
| 35 | Keep the runtime on `127.0.0.1` unless you deliberately front it with trusted |
| 36 | local networking controls. |
| 37 |