flamecast

Command-line client for Flamecast. Manage cloud agents and sessions from your terminal.

Install

git clone https://github.com/smithery-ai/flamecast-cli
cd flamecast-cli
bun install
bun run build       # compiles dist/flamecast

Requires Bun for source builds. The compiled binary runs standalone.

Quickstart

flamecast login     # browser sign-in, stores an API key locally
flamecast whoami
flamecast agents
flamecast sessions

Commands

Command	What it does
flamecast login	Sign in via the browser. Stores an API key.
flamecast logout	Clear the local API key.
flamecast whoami	Print the currently authed identity.
flamecast config	Show config file path + base URL.
flamecast agents	List agents in your workspace.
flamecast sessions	List recent sessions.
flamecast sessions create --input <text>	Launch a Think session.
flamecast sessions get <sessionId>	Show one session.
flamecast sessions events <sessionId>	Dump the event log.

Launching a session

export AI_GATEWAY_API_KEY=vck_...
flamecast sessions create --input "summarize my open Linear tickets"

Flags on sessions create:

Flag	Default	Notes
--input <text>	(required)	First message to the agent.
--model <id>	anthropic/claude-haiku-4-5	Any Think-supported model.
--agent-id <id>	none	Launch a saved agent instead of an inline runtime.
--async	off	Return immediately; poll sessions get / sessions events for progress.

Configuration

Credentials live at ~/.config/flamecast/config.json (respects $XDG_CONFIG_HOME). Delete the file or run flamecast logout to clear.

Env var	Default	Notes
FLAMECAST_URL	https://flamecast.dev	Point at a different worker.
AI_GATEWAY_API_KEY	none	Required for sessions create with inline runtime. Flamecast does not supply one.

Development

bun run bin/flamecast.ts <command>     # run from source
bun run typecheck                       # type-check