Alumia CLI

Installable terminal agent and MCP server for Alumia.

bun install -g @hasna/alumia
alumia login --device
alumia login --device --base-url http://spark01:3325 # local development
alumia login --profile local --api-key "$ALUMIA_API_KEY" --base-url http://spark01:3325 --org "$ALUMIA_ORG"
alumia
alumia exec "Summarize my latest project"
alumia export project <project-id> --out ./alumia-project --format filesystem
alumia import ./alumia-project
alumia mcp install --target codex
alumia mcp --stdio

The default alumia command starts device-login onboarding against https://alumia.com when no profile is configured, then enters the OpenTUI terminal agent after browser approval. Use --base-url or ALUMIA_BASE_URL for local development servers. Non-TTY shells fall back to line mode once configured. alumia exec is intended for scripts and CI. alumia config list/use/set/delete manages named local profiles. alumia import validates or restores local exports. alumia mcp --stdio exposes Alumia tools to MCP clients over stdio using the same API client and credentials.

Commands

| Command | Purpose | | --- | --- | | alumia | Start the terminal agent. Uses OpenTUI in an interactive TTY and line mode for pipes/scripts. | | alumia help / alumia --help | Show command help. | | alumia version / alumia --version | Print the package version. | | alumia login | Save API-key, email/password, or device-login credentials. Supports --profile, --base-url, --org, --workspace/--workspace-id. | | alumia logout | Remove credentials from the selected profile. | | alumia config ... / alumia profiles | Inspect, switch, update, or delete local profiles. config set supports base-url, org, workspace-id, agent, project, model, api-key, and access-token. | | alumia whoami | Print the authenticated user/org. | | alumia doctor | Probe health, identity, agents, and models. | | alumia agents / projects / sessions / models | List app resources. | | alumia exec "prompt" | Run one agent turn; use --json for scripts. | | alumia export ... | Write project/session/artifact/dataset/files exports as JSON, Markdown, filesystem, or zip. | | alumia import ... / restore ... | Validate or apply supported local exports. | | alumia api METHOD /path | Call an authenticated /api/v1 endpoint, optionally with --body or --body-file. | | alumia mcp | List configured Alumia MCP servers. | | alumia mcp --stdio | Run the stdio MCP server. | | alumia mcp install / mcp doctor | Install or inspect local Codex/Claude/Gemini MCP config. |