|
| 1 | +# TAGLINE |
| 2 | + |
| 3 | +Self-contained terminal coding agent with multi-provider and offline support |
| 4 | + |
| 5 | +# TLDR |
| 6 | + |
| 7 | +**Launch interactive terminal UI** |
| 8 | + |
| 9 | +```ante``` |
| 10 | + |
| 11 | +**Run a one-shot headless task** |
| 12 | + |
| 13 | +```ante -p "[add error handling to src/main.rs]"``` |
| 14 | + |
| 15 | +**Pipe a diff for review** |
| 16 | + |
| 17 | +```git diff | ante -p "[review this for security issues]"``` |
| 18 | + |
| 19 | +**Use a specific provider and model** |
| 20 | + |
| 21 | +```ante --provider [openai] --model [gpt-5.5] -p "[refactor the database module]"``` |
| 22 | + |
| 23 | +**Run fully offline with a local GGUF model** |
| 24 | + |
| 25 | +```ante --offline-model [~/.ante/models/model.gguf] -p "[add tests]"``` |
| 26 | + |
| 27 | +**Resume a saved session** |
| 28 | + |
| 29 | +```ante --resume [ses_...] -p "[now add tests]"``` |
| 30 | + |
| 31 | +**Update to the latest release** |
| 32 | + |
| 33 | +```ante update``` |
| 34 | + |
| 35 | +# SYNOPSIS |
| 36 | + |
| 37 | +**ante** [_options_] [**-p** _prompt_] |
| 38 | + |
| 39 | +**ante** **serve** |
| 40 | + |
| 41 | +**ante** **gateway** |
| 42 | + |
| 43 | +**ante** **update** [_options_] |
| 44 | + |
| 45 | +# PARAMETERS |
| 46 | + |
| 47 | +**-p**, **--prompt** _PROMPT_ |
| 48 | +> Run in headless mode with the given prompt and exit when done |
| 49 | +
|
| 50 | +**-m**, **--model** _MODEL_ |
| 51 | +> Override the model name |
| 52 | +
|
| 53 | +**--provider** _PROVIDER_ |
| 54 | +> Override the API provider (for example anthropic, openai, gemini, xai, openrouter, local) |
| 55 | +
|
| 56 | +**--profile** _NAME_ |
| 57 | +> Use **~/.ante/**_NAME_**.settings.json** instead of the default settings; **ANTE_PROFILE** is equivalent |
| 58 | +
|
| 59 | +**--effort** _LEVEL_ |
| 60 | +> Override model effort: min, low, medium, high, xhigh, or max |
| 61 | +
|
| 62 | +**--yolo** |
| 63 | +> Skip all interactive tool approval prompts |
| 64 | +
|
| 65 | +**--output-format** _FORMAT_ |
| 66 | +> Headless output format: json, human, or minimal (default: minimal) |
| 67 | +
|
| 68 | +**--offline-model** _PATH_ |
| 69 | +> Path to a local GGUF model file; boots built-in local inference and uses the local provider |
| 70 | +
|
| 71 | +**-r**, **--resume** _SESSION_ID_ |
| 72 | +> Resume a previously saved session by ID |
| 73 | +
|
| 74 | +**--no-session-save** |
| 75 | +> Do not persist a transcript or resumable snapshot |
| 76 | +
|
| 77 | +**--check** |
| 78 | +> After the main task, run a verification pass on the work |
| 79 | +
|
| 80 | +**--system-prompt** _PROMPT_ |
| 81 | +> Replace the default system prompt entirely |
| 82 | +
|
| 83 | +**--system-prompt-file** _PATH_ |
| 84 | +> Read a replacement system prompt from a UTF-8 file |
| 85 | +
|
| 86 | +**--append-system-prompt** _TEXT_ |
| 87 | +> Append text to the system prompt |
| 88 | +
|
| 89 | +**--no-skills** |
| 90 | +> Skip skill discovery; no skills are advertised or invocable |
| 91 | +
|
| 92 | +**--tools** _TOOLS_... |
| 93 | +> Replace the default tool set with exactly these tools |
| 94 | +
|
| 95 | +**--include-tools** _TOOLS_... |
| 96 | +> Add tools on top of the default or **--tools** set |
| 97 | +
|
| 98 | +**--exclude-tools** _TOOLS_... |
| 99 | +> Remove tools after **--tools** and **--include-tools** |
| 100 | +
|
| 101 | +# COMMANDS |
| 102 | + |
| 103 | +**serve** |
| 104 | +> Run as a long-lived daemon over a structured JSONL protocol for editor plugins and integrations |
| 105 | +
|
| 106 | +**gateway** |
| 107 | +> Run Ante as a Slack or Discord bot |
| 108 | +
|
| 109 | +**update** |
| 110 | +> Install the latest release; supports **--channel** and **--version** |
| 111 | +
|
| 112 | +# DESCRIPTION |
| 113 | + |
| 114 | +**ante** is a self-contained coding agent from Antigma Labs that runs in the terminal. It is distributed as a single Rust binary (~15MB) with no runtime language dependencies. Day-to-day use is an interactive TUI (**ante** with no arguments); headless one-shots use **-p** / **--prompt**. |
| 115 | + |
| 116 | +It works with many cloud providers (Anthropic, OpenAI, Gemini, Grok/xAI, Open Router, and OpenAI-compatible endpoints) via API keys or OAuth, and can also run fully offline against a local GGUF model through a built-in inference engine. Configuration lives under **~/.ante/** (settings, catalog, and optional named profiles). |
| 117 | + |
| 118 | +Subcommands cover programmatic embedding (**ante serve**), chat-platform bots (**ante gateway**), and self-updates (**ante update**). Features include multi-agent orchestration, skills, MCP servers, and persistent memory across sessions. |
| 119 | + |
| 120 | +# CAVEATS |
| 121 | + |
| 122 | +Ante is in alpha/preview: expect breaking changes and incomplete functionality. Official support is macOS and Linux (Windows users are directed to WSL). Headless mode implies auto-approval of tool calls (yolo). Cloud providers need credentials (for example **ANTHROPIC_API_KEY**, **OPENAI_API_KEY**); offline mode needs a local GGUF. The prebuilt binary is free to use during the alpha under separate binary terms; open-source parts of the repository are Apache-2.0. Install via the official script (**curl -fsSL https://ante.run/install.sh | bash**); distro packages named **ante** are typically a different project (the Ante programming language). |
| 123 | + |
| 124 | +# CONFIGURATION |
| 125 | + |
| 126 | +Default settings: **~/.ante/settings.json** |
| 127 | + |
| 128 | +Named profiles: **~/.ante/**_name_**.settings.json** (select with **--profile** or **ANTE_PROFILE**) |
| 129 | + |
| 130 | +Provider/model catalog overrides: **~/.ante/catalog.json** |
| 131 | + |
| 132 | +Binary install location defaults to **~/.ante/bin** (override with **ANTE_INSTALL_DIR** during install) |
| 133 | + |
| 134 | +# SEE ALSO |
| 135 | + |
| 136 | +[claude](/man/claude)(1), [codex](/man/codex)(1), [opencode](/man/opencode)(1), [aider](/man/aider)(1), [goose](/man/goose)(1) |
| 137 | + |
| 138 | +# RESOURCES |
| 139 | + |
| 140 | +```[Source code](https://github.com/AntigmaLabs/ante)``` |
| 141 | + |
| 142 | +```[Homepage](https://antigma.ai)``` |
| 143 | + |
| 144 | +```[Documentation](https://docs.antigma.ai)``` |
| 145 | + |
| 146 | +<!-- verified: 2026-08-10 --> |
0 commit comments