🐝 apiario — CLI Harness

An npx-installable CLI tool that wraps pi.dev (v0.74.0), pre-configured to use Apiário's API (api.apiario.dev) as the LLM provider. Launches directly into pi's TUI interactive mode.

Usage

# Run directly (requires Node >= 20.6.0)
npx apiario

# Or with an explicit API key
APIARIO_API_KEY=sk-... npx apiario

On first run, the tool will guide you through setting up your API key.

Quick start

1. Get an API key at platform.apiario.dev/auth
2. Run npx apiario
3. Paste your sk-... key when prompted
4. Start chatting in the TUI

Environment variables

| Variable | Required | Description | | ----------------- | -------- | ------------------------------------------------------------------- | | APIARIO_API_KEY | No | API key. Falls back to ~/.config/apiario/settings.json if not set |

Config file location

All configuration is stored under ~/.config/apiario/:

• settings.json — API key
• models.json — Cached model list (24 h TTL)

Development

# Install dependencies
cd harness && npm install

# Build
npm run build

# Watch mode
npm run dev

# Run locally
node dist/cli.js

License

MIT