Astra Code Terminal (TypeScript + Ink)

astra-code-term is the npm-first Astra terminal client built with TypeScript, React, and Ink.

Install

Global (recommended)

cd astra-code-term
npm install
npm run build
npm install -g .

Then run:

astra

Local development

cd astra-code-term
npm install
npm run dev

Configure

Create .env from .env.example:

cp .env.example .env

Supported variables:

• ASTRA_BACKEND_URL (default: https://api.astraaifor.me)
• ASTRA_MODEL (default: gpt-5.1-codex)
• ASTRA_CLIENT_ID (default: astra-code)
• ASTRA_RUNTIME_MODE (default: astra-code)
• ASTRA_TTS_COMMAND (optional; command used for text-to-speech, receives text as final arg)
• ASTRA_STT_COMMAND (optional; command used for one-shot speech-to-text; must print transcript to stdout)
• ASTRA_STT_MODEL (default: whisper-1, low-cost OpenAI Whisper transcription)
• ASTRA_STT_CHUNK_SECONDS (default: 2.5, chunk size for live transcription)
• ASTRA_STT_CAPTURE_COMMAND (optional; custom mic capture command with {output} and {seconds} placeholders)
• OPENAI_API_KEY or ASTRA_OPENAI_API_KEY (required for built-in Whisper live STT)

Runtime behavior

No-args mode launches the Ink terminal UI:

• login / signup
• chat streaming via /api/agent/chat/stream
• slash commands:
  • /help, /new, /settings, /logout, /exit
  • /history (open searchable session history panel)
  • /voice on|off|status|start|stop|input
• tool-event rendering (tool_start, tool_result, credits_update, error)
• terminal bridge auto-run for run_in_terminal + callback to /api/agent/terminal-result

Command mode:

astra help
astra whoami
astra sessions
astra skills
astra skills --suggest "build dashboard with animations"
astra session-messages --session <session_id>
astra logout
astra legacy-python --help

Validation

npm run typecheck
npm run build
npm run start -- help

Legacy Python runtime

The previous Python runtime remains in ../astra-code during transition. Use:

astra-code legacy-python

If your shell resolves astra-code to an older Python symlink first, run the npm-installed binary directly (example):

~/.nvm/versions/node/<node-version>/bin/astra-code help

Published package:

npm i -g @astra-code/astra-ai

Run without global install:

npx @astra-code/astra-ai