Skip to content

README.md

Latest commit

 

History

History
52 lines (35 loc) · 1.43 KB

README.md

File metadata and controls

52 lines (35 loc) · 1.43 KB
Raw

@repo/cli

TypeScript CLI to interact with the Basilic Fastify API via @repo/core. API key auth only; auth endpoints excluded. Ideal for agentic integrations (e.g. OpenClaw) as a simpler alternative to MCP.

Usage

pnpm --filter @repo/cli build
node packages/cli/dist/cli.js --help

Auth

Requires an API key. Resolved in order:

  1. API_KEY or BASILIC_API_KEY env var
  2. Config file (~/.config/basilic/config.json or $XDG_CONFIG_HOME/basilic/config.json)
  3. Interactive prompt (saves to config)
# Set via env
export API_KEY=bask_xxx_yyy

# Or save to config
basilic config set-api-key bask_xxx_yyy

Commands

Commands mirror the core API nesting (excluding auth endpoints): health-check, account apikeys create, account apikeys list, ai chat, etc. Use --help on any command for OpenAPI-derived descriptions.

Local testing

  1. Start API: pnpm dev

  2. Create API key via dashboard or POST /account/apikeys/ with JWT

  3. Run:

    API_KEY=bask_xxx node packages/cli/dist/cli.js health-check
API_KEY=bask_xxx node packages/cli/dist/cli.js account apikeys list

  4. Or build and run:

    pnpm --filter @repo/cli build
pnpm --filter @repo/cli exec basilic health-check

Agentic integrations

The CLI is designed for AI agents (OpenClaw, Cursor Composer, etc.) as a lightweight alternative to MCP: standard stdout/JSON, no server setup, easy to wrap in scripts.