TODO for AI Edge

The Web connector for TODO for AI — connects your machine to the TODO for AI server and gives TODOs shell, file, and browser access to get things done locally. Handles file operations, shell execution, DOCX/XLSX editing, git-aware file-change tracking, and more.

For setup details, prebuilt binaries (Windows, macOS, Linux), and what the connector enables, see the Edge download page.

Quickstart

curl -fsSL https://todofor.ai/edge | sh   # standalone binary, no Node required
todoforai-edge

Already have Node? npm install -g @todoforai/edge works too. On Windows: irm https://todofor.ai/edge.ps1 | iex.

First run opens your browser for device-flow login and saves the key to the platform credentials store (~/.config/todoforai/credentials.json on Linux, ~/Library/Application Support/todoforai/credentials.json on macOS, %APPDATA%\todoforai\credentials.json on Windows; legacy ~/.todoforai/credentials.json still read). Shared with the bridge and CLI. No flags needed.

Other ways to authenticate

todoforai-edge --api-key sk_...          # one-shot, not persisted (also: --api-key=$MY_API_KEY)

Get a key at todofor.ai/apikey.

From source

git clone https://github.com/todoforai/edge.git
cd edge/bun
bun install
bun run src/index.ts

Compile standalone binary

cd bun
bun build src/index.ts --compile --outfile dist/todoforai-edge

Development

export TODOFORAI_API_KEY_DEV="your-local-dev-api-key"

make run          # Production
make run-dev      # Local (http://localhost:4000)

What it does

• Shell — execute commands with streaming output and PTY (interrupt, stdin)
• Filesystem — read/write/search files, workspace tree, gitignore-aware
• Documents — DOCX/XLSX/PDF read & edit
• Managed runtimes — auto-provisions Python venv, Node.js packages, and native binaries under ~/.todoforai/tools/ (added to PATH)
• Tool catalog — on-demand install of CLIs like gh, rg, cloudflared, supabase, stripe, flyctl, …
• Browser bridge — drive the user's own browser via the TODOforAI extension (CDP, controlled with agent-browser) (Chrome · Firefox)

See API_USAGE.md for the full function list and message protocol.

License

MIT License with Notification Request - see the LICENSE file for details.