DOCS/GETTING-STARTED/INTRODUCTION

introduction

Introduction to Andromity

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.


Why a Terminal-Native Agent?

The command line is where developer efficiency lives. By placing an AI agent inside a terminal TUI, Andromity achieves several unique benefits:

  1. Context Awareness: Andromity is inside your working directory. It runs tests, reads files, and executes build scripts directly.
  2. Speed & Efficiency: No GUI overhead. Interaction is keyboard-first and instantaneous.
  3. Safety First: Features a granular, interactive tool approval framework. You decide exactly what modifications are made before they touch your git tree.
  4. Universal Integration: Integrates with any editor (VS Code, Cursor, Vim, Emacs) since it resides in the terminal panel below your editor.

Key Pillars of Andromity1. Model Context Protocol (MCP)

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.

2. Multi-Agent Collaboration

Toggle between dedicated profiles like builder (planning-heavy development), coder (instant modifications), reviewer (auditing codebases), and planner (creating architecture guides).

3. Bring Your Own Intelligence (BYOY)

Use cloud-hosted models (Anthropic Claude, OpenAI GPT, Google Gemini, Groq, OpenRouter) or local execution (Ollama, local llama.cpp endpoints).

4. Secure Remote Access

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.


Next Steps

To begin using Andromity on your computer: