@aiagentwiki/cli

Command-line interface for AgentWiki — manage notes, documents, media, publish static sites, and query your knowledge base from the terminal.

Install

# Global install
npm i -g @aiagentwiki/cli

# Or run without installing
npx @aiagentwiki/cli --help

Requires Node.js >=20.

Usage

agentwiki --help
agentwiki login --api-key aw_xxxxx
agentwiki whoami

Authentication

Credentials are resolved with this precedence (highest → lowest):

1. Environment variables — AGENTWIKI_API_KEY, AGENTWIKI_API_URL
2. Credentials file — ~/.agentwiki/credentials.json (written by agentwiki login)
3. Defaults — apiUrl = https://api.agentwiki.cc

Environment variables

| Variable | Purpose | |---|---| | AGENTWIKI_API_KEY | API key — bypasses login, ideal for CI/Docker/automation | | AGENTWIKI_API_URL | Override API base URL (self-hosted, staging) |

Example (GitHub Actions):

- name: Publish site via AgentWiki CLI
  env:
    AGENTWIKI_API_KEY: ${{ secrets.AGENTWIKI_API_KEY }}
  run: npx @aiagentwiki/cli sites deploy ./build --name my-site

Use agentwiki whoami to verify which source (env/file/default) is in effect.

See the main repository README for the full command reference.

License

MIT