CLI Reference

Run setup, manage services, install plugins and skills, inspect logs, and reset local state.

Commands

Command	Purpose
setup	Run the first-use wizard and write local configuration
init	Initialize local OpenNeko state
install	Install a trusted marketplace plugin or community skill from a git URL
remove	Remove an installed plugin
list	List installed plugins
doctor	Diagnose environment and service issues
marketplace	Manage marketplace sources
secrets	Manage local secrets
version	Print CLI version
start	Start the stack
stop	Stop the stack
status	Show service status
logs	Tail or inspect service logs
migrate	Run database migrations
seed	Seed demo or development data
reset	Reset local config or runtime state

Local mode

The persistent --local flag forces local execution. Plugin operations normally auto-proxy into the worker container when that is the correct runtime boundary.

Common diagnostics

openneko --local doctor
openneko status
openneko logs worker

Build from source

Contributors can run the monorepo directly. The source development path bootstraps packages, starts dependencies, migrates the app database, and runs the local dev server.

Source development

corepack enable
pnpm bootstrap
pnpm dev:up
(cd apps/openneko && go run ./cmd/openneko migrate)
pnpm dev

# Optional host-only helper CLIs
./scripts/install-clis.sh