CLI

CLI for TODOforAI — create, watch, and inspect AI-powered todos from your terminal. Pipe-friendly, Claude-Code-style.

Platform Support: ✅ Windows · ✅ macOS · ✅ Linux

Install

Code
 
bun install -g @todoforai/cli

Alternative one-liners:

Code
 
# macOS / Linux — auto-detects npm/bun or downloads binary
curl -fsSL https://todofor.ai/cli | sh

# Windows (PowerShell)
irm https://todofor.ai/cli.ps1 | iex

Setup

Just run todoai — on first use it opens a browser for device login and saves the API key to ~/.config/todoforai/credentials.json on Linux (~/Library/Application Support/todoforai/credentials.json on macOS, %APPDATA%\todoforai\credentials.json on Windows). Shared with the edge daemon and the bridge.

Code
 
todoai                # prompts device login if no key found
todoai login          # explicit login

Auth resolution order: --api-key flag → TODOFORAI_API_KEY env → shared credentials → device login.

Edge daemon

The CLI talks to the backend over WebSocket; shell execution, file I/O, and tool calls happen in the edge daemon running locally. On every run todoai spawns a detached edge process if none is running (PID-locked at ~/.todoforai/edge-<hash>.lock, logs at ~/.todoforai/edge.log). It keeps running after the CLI exits, so long-running tasks survive Ctrl+D.

No separate install needed — the edge daemon ships with the CLI.

Usage

Code
 
echo "fix bug in auth.ts" | todoai     # pipe a task
todoai                                  # interactive mode
todoai watch                            # follow live todos

Open Source: github.com/todoforai/cli