Hakonfig
Download
Features Security Pricing FAQ Download

Your provider isn't built in?
We set it up for you.

Claude, Codex and Grok already work in your harness. Hakonfig is for everything else: the free tier nobody has heard of, your school's gateway, your own endpoint. Paste the key and Hakonfig writes the config, with a diff to check before anything is saved.

Download for free See how it works
Harnesses you can configure
Pi oh-my-pi OpenCode Hermes
Providers your harness leaves out
Together AI NVIDIA NIM OpenCode Go Ollama Your own gateway
Also installs for you
Claude Code Codex CLI Gemini CLI Aider Crush Qwen Code
Hakonfig: Manage AI providers
Choose a harness Click one to see the providers you have set up.
Installed 4
Pi 3 providers · 2 connected v1.5.0 supported
oh-my-pi 2 providers · 1 connected v0.9.4 supported
OpenCode 1 provider · no API key v0.6.2 supported
Hermes No providers yet experimental
Not installed 6
Claude Code Anthropic's coding agent Install Docs
Codex CLI OpenAI's CLI agent Install Docs
Gemini CLI Google's terminal agent Install Docs
Aider Pair programming in your terminal Install Docs
Features

You bring the key. Hakonfig handles the rest.

No more hunting through config files, guessing at JSON schemas, or making .bak copies just in case.

Add a provider your harness doesn't know

Point it at any endpoint, even one it has never heard of, and paste the key. Hit Sync models and every model that endpoint serves appears in a list you can tick. No guessing at model IDs, no editing JSON.

Add provider
Base URL
https://ai-gateway.your-campus.edu/v1
API key
••••••••••••••••••••• Show
✓ Connected · 214 ms Sync models
Models found 6
✓qwen3-32b ✓llama-3.3-70b ✓glm-4.6 kimi-k2-instruct mistral-large-2411 deepseek-v3.2
Cancel Save provider

It finds the config files for you

Every harness keeps its settings somewhere different, and your API key often lives in a different file than the model list. Hakonfig shows you exactly where, with a button to open the folder.

Detected locations ✓ ~/.pi/agent/models.json ✓ ~/.pi/agent/auth.json ✓ ~/.pi/agent/settings.json ○ ~/.config/opencode/opencode.json

See every change before it happens

Hakonfig shows a full before-and-after diff of the files it is about to write. Secrets are masked, so it is even safe to screenshot and share.

models.json
"cerebras": { "name": "Cerebras", "baseUrl": "https://api.cerebras.ai/v1" }
"deepseek": { "name": "DeepSeek", … }
auth.json
"cerebras": { "type": "api", "key": "••••••••" }

Nothing is lost. Every write is backed up.

The original files are snapshotted before anything changes. If something looks wrong, restore the previous version in one click.

Saved backups
19:42:05 · now Restore
18:15:30 · 2 hours ago Restore
09:02:11 · yesterday Restore

Install and manage coding harnesses

Hakonfig detects what you already have and shows the version it is running. It can also install other harnesses for you, with the exact command shown for confirmation first. Hakonfig does not manage the provider config of those it only installs.

Not installed
Claude CodeAnthropic's coding agent
Install
Codex CLIInstalling…
Gemini CLIGoogle's terminal agent
Install

Safe by default

Unknown fields are merged, not overwritten. Writes are atomic. Credential files are written with owner-only permissions. And disabling a provider never deletes its data; it just hides it.

✓Unknown fields are merged, never dropped
✓Atomic writes (temp file → rename)
✓Credential files are owner-only (0600)
✓Disabling a provider never deletes its data
Privacy

Your keys stay on your computer.
We never see them.

Hakonfig is not a proxy, not a gateway, and not a vault. It writes only to the files your harness already reads. It does not copy your API keys anywhere, does not send them to any server, and never writes them to a log.

  • ✓No telemetry. No cloud sync. No account.
  • ✓Works fully offline. Only "Test connection" needs the network.
  • ✓Secrets are always masked in previews and diffs.
~/.pi/agent/auth.json "deepseek": { "key": "••••••••" }

Credential files are written with owner-only permissions (0600).

Pricing

Free for personal use

$0

Open source under the MIT license. Every feature is included: no locked tiers, no account, no upsell. You pay only your AI provider, through the plan or API key you already have.

Download free
Questions

Straight answers

Hakonfig is a desktop app for macOS, Windows and Linux that reads, edits and writes the AI provider configuration for coding harnesses like Pi, oh-my-pi, OpenCode and Hermes. Instead of editing JSON or YAML by hand, you add a provider through a simple form and Hakonfig writes the correct files for you.

Anyone who has an API key and a coding harness but does not know where the config file is or what shape it should be. If you have ever opened a JSON file hunting for the place to paste a key, and then made a .bak copy just in case, this is for you.

Probably not, if everything you use is built in. Hakonfig is for the providers a harness leaves out: a free tier it has never heard of, a gateway your school or team runs, or any OpenAI-compatible endpoint. Those normally mean hand-editing a config file that the harness never documents properly. That is the part Hakonfig does for you.

Yes. Hakonfig is open source under the MIT license and free for personal and classroom use. You only ever pay your AI provider.

No. Hakonfig has no server and no account. Your key stays in the file your harness already reads. The only time it leaves your machine is when you press "Test connection", and then it only goes to that provider's endpoint.

Pi, oh-my-pi and OpenCode are fully supported; Hermes is experimental. Hakonfig can also install Claude Code, Codex CLI, Gemini CLI, Aider, Crush and Qwen Code for you, though it cannot manage their configuration yet.

You basically cannot. Hakonfig backs up the original files before every write, shows you a full before-and-after diff first, and merges rather than overwrites, so fields it does not recognise are kept. If something still looks wrong, restore the previous snapshot in one click.

Open Hakonfig, pick your harness, click "+ Add provider", choose a provider, paste your API key, click "Find models", tick the models you want, then Save. Review the diff and click Write to disk.

Download

Pick your platform

One small app (about 5 MB) to manage every AI provider in your coding harness.

macOS Apple silicon · macOS 13+
Download
Windows Windows 10+ · x64
Download
Linux .deb · .rpm · AppImage
Download