@atlas-coder/atlas-agent

Atlas Agent — terminal-first AI coding assistant.

Install

npm install -g @atlas-coder/atlas-agent
atlas-agent

On install, the matching native binary for your OS/arch is downloaded from the GitHub release that matches this package version.

On Windows x64, installation and updates also run atlas-agent voice install. This downloads the offline Vosk runtime and Turkish, English, Italian and French models from their official sources, verifies pinned SHA256 hashes and installs them beside the executable. Downloads total approximately 185 MB; installed assets occupy approximately 344 MB. Existing complete assets are reused. Administrator permission, a transcription API and Whisper are not required. Failed speech setup leaves the coding CLI installed and usable.

Use atlas-agent voice install to retry downloads and atlas-agent voice status to check recognition. ATLAS_AGENT_SKIP_SPEECH_SETUP=1 skips automatic downloads. Menu language selects the dictation model unless option voice language is set. option voice model-dir and option voice runtime-dir support custom paths.

The legacy Windows engine remains optional: set option voice backend windows. atlas-agent voice setup installs its Windows components and may request UAC. Set ATLAS_AGENT_VOICE_BACKEND=windows before npm installation to choose this optional setup instead of Vosk downloads. That legacy engine does not support Turkish or Italian. Arabic models are not installed. Audio remains local.

Usage

atlas-agent                  # interactive mode
atlas-agent run "your task"  # non-interactive
atlas-agent --help           # CLI help
atlas-agent models           # list models
atlas-agent dirs             # show config paths

Supported platforms

| OS | Architectures | | ------- | --------------------- | | Windows | x64 | | macOS | x64 (Intel), arm64 (Apple Silicon) | | Linux | x64 |

License

MIT — see LICENSE.md.