Aixia
How aixia-agent works
A thin wrapper around an open-source coding agent, wired so your prompts and code only ever reach Aixia's own infrastructure.

aixia-agent is a small Go program that wraps opencode, the open-source coding agent. It does three things you'd otherwise do by hand: sign you in with your Aixia account, point the agent at Aixia's own LLM gateway with a key that belongs to you, and keep the configuration up to date. Everything the agent sends (your prompts, your code, its responses) stays inside Aixia-operated infrastructure. Nothing is sent to a third-party AI provider.

The path from launch to model

aixia-agent
The CLI you run. Wraps opencode and handles sign-in and config.
Your machine
sign in · OAuth device flow
authentik
Aixia identity (Entra / LDAP) with MFA. The CLI never sees your password, only a 24-hour session token.
Aixia cluster
identity token
key broker
Validates your token and mints a personal gateway key. Holds the master key, which never leaves the cluster.
Aixia cluster
your personal key returns to your machine
Terminal (TUI)
aixia-agent running in your shell.
Your machine
OpenWork
Optional desktop app (Electron), launched by aixia-agent with the same environment.
Your machine
both launch the same opencode
opencode
The agent itself, run locally with your key and the managed Aixia config.
Your machine
prompts + code
Aixia LLM gateway
A LiteLLM proxy on Aixia infrastructure, the only place your prompts and code are sent.
Aixia cluster
runs your request
Aixia-hosted models
Responses come back the same way. No third-party AI provider is involved.
Aixia cluster

1 · A wrapper, not a fork

The agent itself is opencode, bundled into the binary and kept current. aixia-agent only supplies the parts that make it “Aixia”: the provider wiring, model, theme, and org rules ship inside the wrapper and are re-applied on every run, so a new release updates everyone at once. Your own additions (such as MCP servers) live in a separate config that is never overwritten.

2 · You sign in with your Aixia account

On first run the CLI starts an OAuth device flow against Aixia's authentik, which is backed by Entra and LDAP. You approve it in a browser on any device; MFA and conditional access apply automatically. The CLI never sees your password, only a short-lived session token. The session is valid for 24 hours, after which you sign in again.

3 · The key belongs to you, and only the cluster holds the master

After sign-in, a small key broker running in the cluster validates your token and mints a personal key for the LLM gateway. The broker is the only thing that holds the gateway's master key, it never leaves Aixia infrastructure and is never baked into the download. Because each person gets their own key, usage is attributable and a single user can be revoked without affecting anyone else.

4 · Prompts and code go only to Aixia's gateway

opencode talks to Aixia's LLM gateway (a LiteLLM proxy on Aixia infrastructure) and nowhere else. There is no path to a public AI provider, and opencode's own session-sharing feature is disabled in the shipped configuration. What you type and the code in your repository are processed within Aixia and are not handed to OpenAI, Anthropic, Google, or any other outside service.

5 · Terminal or desktop, the same engine

You can work straight from the terminal, or install OpenWork, an optional desktop app (an open-source Electron front-end). Either way it launches the same opencode on your machine, with the same per-user key and managed config, OpenWork is just a window onto the local agent, not a separate service, so the sign-in and the data path above are identical. The native Windows (.msi) and macOS (.pkg) installers bundle it; the aixia-agent wrapper launches it with the right environment so it inherits your Aixia configuration.

Why it's safe

Your data stays inside Aixia

Identity is handled by authentik, not the binary

Downloads are verified end to end

One honest caveat: the native installers (Windows .msi, macOS .pkg) aren't code-signed with an OS vendor certificate yet, so Windows SmartScreen and macOS Gatekeeper warn on first open. The minisign signature and checksums still prove the download is genuine; OS-level signing is a planned addition.