Install Andromity for VS Code and Terminal

Andromity can be installed as a native VS Code extension, a standalone CLI/TUI application, or from source for development.

PrerequisitesCopy Anchor Link

Before installing Andromity, ensure your system meets the following requirements:

• Python: >= 3.11 (Python 3.12 and 3.13 are fully supported)
• Git: Installed and accessible in your system PATH
• Operating Systems: macOS (Apple Silicon / Intel), Linux (x86_64 / arm64), Windows 10/11 (PowerShell & WSL2)
• Node.js (Optional): >= 18.0.0 (required only if running custom TypeScript MCP servers)

1. VS Code Extension InstallationCopy Anchor Link

The VS Code extension provides the rich UI experience with Secondary Sidebar docking, interactive diff overlays, and the live waterfall profiler.

Marketplace InstallationCopy Anchor Link

1. Open VS Code.
2. Press Ctrl + P (or Cmd + P on macOS).
3. Paste the following command and press Enter:

ext install agenticmarket.andromity-agent

CLI Extension InstallationCopy Anchor Link

If you prefer installing from terminal:

code --install-extension agenticmarket.andromity-agent

2. Standalone Terminal CLI InstallationCopy Anchor Link

The terminal runtime provides the raw engine with a terminal user interface (TUI) powered by Textual and Rich.

curl -fsSL https://raw.githubusercontent.com/agenticmarket/andromity/main/install.sh | bash

3. Verifying InstallationCopy Anchor Link

Verify that the CLI executable is available in your shell:

andromity --version

Start an interactive session:

andromity

Run a one-shot scripted command in headless mode:

andromity run "analyze git status and report pending changes" --dry-run

4. Platform-Specific NotesCopy Anchor Link

Windows Store PythonCopy Anchor Link

If Python was installed via the Microsoft Store, Windows virtualizes local app data. Your configuration files will reside in:

%LOCALAPPDATA%\Packages\PythonSoftwareFoundation.Python.3.12_qbz5n2kfra8p0\LocalCache\Roaming\andromity\

For standard native Python or pyenv-win installations, files are stored at %APPDATA%\andromity\config.toml.

Linux Headless ServersCopy Anchor Link

When running Andromity on remote servers via SSH, ensure your terminal supports 256-color or truecolor mode (export TERM=xterm-256color) for optimal Textual rendering.