## Agent not connected

Fastest way to start Try minicode for free with OpenRouter

Create a free OpenRouter account, connect it to this `minicode serve` session, and use free models without editing config files first.

Local quick connect Connect OpenAI-compatible

Choose a preset like LM Studio, OpenAI, Ollama, or Custom, then adjust the endpoint if needed before connecting this `minicode serve` session.

Starts with common presets, but the endpoint stays editable.
Hosted model Connect Anthropic

Paste an Anthropic API key to connect this `minicode serve` session without editing config files first.

Session-only by default, with optional persistence.

minicode needs a model provider to run. Configure one of the following:

Local model (LM Studio, Ollama, etc.)

Start your local server, then set in `~/.minicode/.env`:

    MODEL_PROVIDER=openai-compatible
    OPENAI_BASE_URL=http://localhost:1234/v1
    MODEL=your-model-name

Anthropic API

Set in `~/.minicode/.env` or your shell environment:

    MODEL_PROVIDER=anthropic
    ANTHROPIC_API_KEY=sk-ant-...
    MODEL=claude-sonnet-4-20250514

OpenRouter / remote OpenAI-compatible

Set it manually in `~/.minicode/.env` or your shell environment:

    MODEL_PROVIDER=openai-compatible
    OPENAI_BASE_URL=https://openrouter.ai/api/v1
    OPENROUTER_API_KEY=sk-or-...
    MODEL=your-model-name

Deterministic analysis

## Structural findings

Graph-driven

These signals come from the dependency graph itself, not from agent judgment.

Run analysis to inspect cycles, hotspots, and coupling outliers.

## Settings

Persist non-secret global defaults in `~/.minicode/.env` for future sessions.

Env file ``
Anthropic is connected for this serve session
OpenRouter is connected for this serve session
OpenAI-compatible provider is connected for this serve session
Quick connect
Temporarily connect a provider for this serve session, or optionally save it to `~/.minicode/.env`.
Loading settings...

## Connect OpenRouter

Authorize this `minicode serve` session and optionally save the resulting setup for future runs.

minicode will redirect you to OpenRouter so you can sign in and approve access. By default, the resulting API key is used only for this live serve session.

Optional persistence

If you opt in below, minicode will update `~/.minicode/.env` after sign-in so future runs can reuse this OpenRouter setup.

Save the OpenRouter credentials and provider defaults to `~/.minicode/.env` after sign-in.

When enabled, minicode will store `OPENROUTER_API_KEY` and set `MODEL_PROVIDER` plus `OPENAI_BASE_URL` for OpenRouter. Nothing is written unless you check the box.

## Connect OpenAI-compatible

Configure an OpenAI-compatible endpoint for this `minicode serve` session and optionally save it for future runs.

Pick a preset to prefill a common endpoint, then adjust it if needed. minicode will point this serve session at the OpenAI-compatible API endpoint you provide.

Connection details

Local runtimes like LM Studio or Ollama usually work without an API key, while hosted providers like OpenAI typically require one. The endpoint stays editable no matter which preset you choose.

Preset

LM Studio pre-fills the default local server endpoint at `http://localhost:1234/v1`.

Endpoint API key (optional) Save the OpenAI-compatible provider defaults to `~/.minicode/.env` after connecting.

When enabled, minicode will update `MODEL_PROVIDER` and `OPENAI_BASE_URL`, and it will also write `OPENAI_API_KEY` if you provide one. Nothing is written unless you check the box.

## Connect Anthropic

Configure Anthropic for this `minicode serve` session and optionally save it for future runs.

Paste an Anthropic API key to point this serve session at the Anthropic runtime path. By default, the key is held only by this live session.

Connection details

minicode will use `MODEL_PROVIDER=anthropic` for this session. Select an Anthropic model afterward if one is not already configured.

API key Save the Anthropic credentials and provider default to `~/.minicode/.env` after connecting.

When enabled, minicode will write `ANTHROPIC_API_KEY` and set `MODEL_PROVIDER=anthropic`. Nothing is written unless you check the box.

## File preview

Loading…

    Loading...

## Allow this action?

The agent wants to run a tool that modifies your workspace.

Tool ``
Input