@astra-code/astra-ai 0.1.0

package/.env.example

@@ -0,0 +1,19 @@
+ASTRA_BACKEND_URL=https://api.astraaifor.me
+ASTRA_MODEL=gpt-5.1-codex
+ASTRA_CLIENT_ID=astra-code
+ASTRA_RUNTIME_MODE=astra-code
+# Optional provider override when model-based detection is not desired.
+# Examples: openai, claude
+ASTRA_PROVIDER=
+# Optional voice mode adapters:
+# - TTS: command receives spoken text as final argument (default on macOS uses `say`)
+# - STT: one-shot command must print transcript text to stdout
+ASTRA_TTS_COMMAND=
+ASTRA_STT_COMMAND=
+# Optional: live Whisper transcription tuning
+ASTRA_STT_MODEL=whisper-1
+ASTRA_STT_CHUNK_SECONDS=2.5
+# Optional override for microphone capture.
+# Use placeholders {output} and {seconds}.
+# Example (macOS): sox -q -d -r 16000 -c 1 -b 16 "{output}" trim 0 {seconds}
+ASTRA_STT_CAPTURE_COMMAND=

package/README.md

@@ -0,0 +1,109 @@
+# Astra Code Terminal (TypeScript + Ink)
+
+`astra-code-term` is the npm-first Astra terminal client built with TypeScript, React, and Ink.
+
+## Install
+
+### Global (recommended)
+
+```bash
+cd astra-code-term
+npm install
+npm run build
+npm install -g .
+```
+
+Then run:
+
+```bash
+astra
+```
+
+### Local development
+
+```bash
+cd astra-code-term
+npm install
+npm run dev
+```
+
+## Configure
+
+Create `.env` from `.env.example`:
+
+```bash
+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:
+
+```bash
+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
+
+```bash
+npm run typecheck
+npm run build
+npm run start -- help
+```
+
+## Legacy Python runtime
+
+The previous Python runtime remains in `../astra-code` during transition. Use:
+
+```bash
+astra-code legacy-python
+```
+
+If your shell resolves `astra-code` to an older Python symlink first, run the npm-installed binary directly (example):
+
+```bash
+~/.nvm/versions/node/<node-version>/bin/astra-code help
+```
+
+Published package:
+
+```bash
+npm i -g @astra-code/astra-ai
+```
+
+Run without global install:
+
+```bash
+npx @astra-code/astra-ai
+```