Skip to main content

Quickstart

Prerequisites​

  • An Antix account, an Anthropic (Claude) subscription, an OpenAI (ChatGPT/Codex) subscription, or a provider API key.
  • You can also use offline mode with no account or API key.

Installation​

Ante is distributed as a single, self-contained binary with no external dependencies — just download and run.

curl -fsSL https://ante.run/install.sh | bash

By default this installs to ~/.ante/bin and configures your shell's PATH. Open a new terminal to run ante, or use ~/.ante/bin/ante immediately in the current terminal. Run ante --version to check the installation; this guide targets v0.3.2.

To install somewhere else, set ANTE_INSTALL_DIR:

curl -fsSL https://ante.run/install.sh | ANTE_INSTALL_DIR=/usr/local/bin bash

Run the default installer as your normal user, not with sudo. A sudoed home-directory install would leave ~/.ante root-owned and prevent Ante from saving settings and input history, so the installer refuses that combination.

macOS release binaries are Developer ID-signed and notarized, so Gatekeeper accepts them without a manual security bypass.

Start with your existing account or key​

Already have one of the accounts above or a provider API key? Open your project and start Ante:

cd your-project
ante

If your API key is already exported in your shell, or you've previously signed in through Ante, you're ready to send a prompt. Ante detects available credentials automatically; no Antix login is required to use another provider.

Ante detects keys such as ANTHROPIC_API_KEY, OPENAI_API_KEY, and GEMINI_API_KEY. See the provider catalog for all supported providers and environment variables.

Using an account for the first time in Ante? Type /providers, select Antix, Anthropic Subscription, or OpenAI Subscription, press m, and sign in through your browser. The same view takes an API key.

Log in with Antix​

To connect an Antix account from the command line, sign in before starting a session:

ante auth login antix

Complete sign-in in the browser, then return to your terminal. Ante saves your credentials for future sessions.

Open your project and start chatting:

cd your-project
ante --provider antix

Try a first prompt such as Explain how this project is organized and where its main entry point is.

You can also sign in inside the TUI: run ante, type /providers, select Antix, and press m. To use another provider's OAuth login or an API key, see Connect a provider.

Quick examples​

Interactive session​

# Launch the TUI — chat with the agent, approve tool calls, view diffs
ante

Headless one-shot​

# Run a task and exit
ante -p "add error handling to src/main.rs"

Pipe input from stdin​

# Pipe file contents for analysis
cat src/lib.rs | ante -p "review this code for bugs"

Use a different provider​

# Override model and provider
ante --provider openai --model gpt-6.1-sol -p "refactor this function"

Skip tool approvals​

# YOLO mode — auto-approve all tool calls
ante --yolo -p "fix all clippy warnings"

Run as a server​

# Start a long-lived daemon for programmatic integration
ante serve

Update to the latest version​

# Check for a new release and install it
ante update

# Try the development channel for one update
ante update nightly

# Roll back or pin to an exact release
ante update --version v0.3.2

What's next?​