Augflow for VS Code

Switch between Augflow cards, worktrees, and tmux sessions without leaving the editor.

This extension talks to a running augflow serve. It does not embed the Augflow web UI.

Requirements

Augflow running locally, or a paired remote host
Visual Studio Code 1.85 or later (also listed on Open VSX)

Get started (local)

Start augflow serve on this machine (default http://127.0.0.1:4400).
Open an Augflow project folder in VS Code.
Open the Augflow view in the activity bar.
If the server has auth enabled, run Augflow: Set API Token.

The token is stored in VS Code Secret Storage, not in settings.

Remote (Augflow Anywhere)

Pair a laptop-native VS Code window with a desktop augflow serve through a named HTTPS tunnel (Cloudflare or reserved ngrok). Quick tunnels change hostname and require pairing again.

On the Augflow machine: Settings → Remote access → generate a pairing key → copy the link.
In VS Code: Augflow: Pair Remote… and paste the https://…/pair?key=… URL.
Confirm the hostname, then approve the device on the Augflow machine.
Select a concrete project (not All Projects).

Remote mode can list cards, run Start / Plan / Implement / Validate, and attach a remote terminal. It will not open laptop folders as if they were the remote worktrees. To edit files, open the Augflow host with VS Code Remote-SSH (or Remote Tunnel).

Remote-SSH, WSL, and container windows stay on the local server of that host.

What you can do

Browse cards and sessions in the sidebar
Switch to a session (attach tmux, optionally add the worktree to Explorer)
Quick-switch with Ctrl/Cmd+Alt+A S
Start, plan, implement, validate, or mark a card done
Review changed files
Pair or unpair a remote host
Switch which Augflow project this window is bound to

Kill Session and Kill Pane ask for confirmation. Most other session actions do not.

Settings

Settings → Extensions → Augflow, or Augflow: Open Settings.

Setting	Default	Notes
`augflow.connectionMode`	`local`	User-level only. `remote` is set after pairing succeeds.
`augflow.baseUrl`	`http://127.0.0.1:4400`	Local server URL. Must be HTTP on loopback.
`augflow.refreshIntervalSeconds`	`15`	How often the sessions tree polls (5–300).
`augflow.autoRevealExplorerOnSwitch`	`true`	Add/reveal the worktree in Explorer on switch. Ignored in remote mode.
`augflow.maxWorkingSetRoots`	`6`	Max open worktree roots (1–20). Oldest unused roots are dropped.
`augflow.maxSessionsPerTerminalGroup`	`1`	Pack more than one card session into the same VS Code terminal tab (1–8).

A workspace .vscode/settings.json cannot override connection mode or base URL.

License

MIT

Augflow

triwibowo