introduction
Welcome to Andromity — the open-source AI development environment for your terminal.
Andromity is an autonomous coding agent that runs directly in your command line, offering a rich Terminal User Interface (TUI) to help you build, refactor, and test software.
Unlike traditional AI coding environments that require heavy IDE packages or lock you into proprietary platforms, Andromity runs on your local machine, respects your permissions, and lets you bring your own LLMs, API keys, and external tools.
The command line is where developer efficiency lives. By placing an AI agent inside a terminal TUI, Andromity achieves several unique benefits:
- Context Awareness: Andromity is inside your working directory. It runs tests, reads files, and executes build scripts directly.
- Speed & Efficiency: No GUI overhead. Interaction is keyboard-first and instantaneous.
- Safety First: Features a granular, interactive tool approval framework. You decide exactly what modifications are made before they touch your git tree.
- Universal Integration: Integrates with any editor (VS Code, Cursor, Vim, Emacs) since it resides in the terminal panel below your editor.
Andromity natively discovers and connects to external API and database resources via MCP. It index tool definitions lazily to minimize token consumption and context windows.
Toggle between dedicated profiles like builder (planning-heavy development), coder (instant modifications), reviewer (auditing codebases), and planner (creating architecture guides).
Use cloud-hosted models (Anthropic Claude, OpenAI GPT, Google Gemini, Groq, OpenRouter) or local execution (Ollama, local llama.cpp endpoints).
Run the terminal agent on your developer rig at home or in the office, and securely review execution or issue new commands from your mobile device, browser, or laptop using a secure web bridge.
To begin using Andromity on your computer:
- Head over to the Quickstart page.
- Configure your preferred LLM provider in the Configuration Guide.
- Learn about the security and approval framework in Permission Modes.