#Commands

#kibaco init

Create a Kibaco config for this local workspace.

kibaco init

Kibaco infers values from package managers, package.json, dev scripts, .env ports, common frameworks, simple backend/server files, monorepo app folders, Compose files, and Supabase local config when possible. Override them with options:

kibaco init --project web --host web.localhost --target http://localhost:3000 --cmd "pnpm dev"
kibaco init --detect
kibaco init --interactive

#kibaco dev

Start services, app commands, and the local proxy.

kibaco dev
kibaco dev web api
kibaco dev --select
kibaco dev --verbose
kibaco dev web --watch-health

With no project names, kibaco dev starts all configured projects and the services referenced by those projects. Project stdout/stderr is written to Kibaco log files but is not streamed to the terminal by default. Use --verbose to stream project logs inline. Use --watch-health to probe each selected project's HTTP health URL every 60 seconds and restart the project after 3 consecutive 500-level responses or connection failures. Kibaco uses an HTTP project.healthCheck.url when configured, otherwise it probes the project target URL. Use --health-interval <seconds> and --health-failures <count> to tune the defaults.

#kibaco restart

Ask the running kibaco dev process to restart project commands.

kibaco restart web
kibaco restart web --force
kibaco restart --all

Use --force when a project needs a hard refresh: Kibaco asks the running kibaco dev process to stop the project command, remove framework cache directories, free the target port, and start it again.

#kibaco clean

Remove framework cache directories for one project or all projects.

kibaco clean web
kibaco clean --all

Kibaco detects common cache directories for Next.js, Vite, Docusaurus, and node_modules/.cache. Project cacheDirs entries are also removed.

#kibaco list

Show configured projects and local URLs.

kibaco list
kibaco list --json

#kibaco urls

Show configured local URLs.

kibaco urls
kibaco urls --json

#kibaco export

Print a shareable JSON view of services, projects, commands, and URLs.

kibaco export

#kibaco doctor

Check config, ports, services, and targets.

kibaco doctor
kibaco doctor --json

--json prints a structured report with workspace, proxyPort, services, projects, and diagnostic issues.

#kibaco status

Show workspace, service, and project status.

kibaco status
kibaco status --json

--json prints the same structured report shape as kibaco doctor --json.

#kibaco ports

Show local listening ports and matching projects.

kibaco ports
kibaco ports --json

#kibaco logs

Show project logs captured by kibaco dev, or service logs for configured services.

kibaco logs
kibaco logs web
kibaco logs web --follow
kibaco logs --all --tail 200
kibaco logs web --jsonl
kibaco logs mysql
kibaco logs mysql --service --tail 200
kibaco logs --all-services

When run in an interactive terminal without a target, kibaco logs lets you choose from configured projects and services.

#kibaco proxy

Start only the local reverse proxy.

kibaco proxy

#kibaco open

List configured project URLs, or open one in the browser.

kibaco open
kibaco open web

#kibaco config

Inspect and safely edit the Kibaco config.

kibaco config validate
kibaco config list-routes
kibaco config set-target web http://localhost:3004
kibaco config import-compose docker-compose.yml --attach web
kibaco config set-service redis --image redis:7 --port 6379:6379
kibaco config set-service postgres --env POSTGRES_DB=app --env POSTGRES_PASSWORD=postgres
kibaco config attach-service web redis postgres
kibaco config detach-service web redis

#kibaco services

Manage services for this workspace.

Import an existing Compose file into Kibaco config and attach those services to a project:

kibaco config import-compose docker-compose.yml --attach web

kibaco services up
kibaco services restart postgres
kibaco services status
kibaco services logs postgres --tail 200 --follow
kibaco services down

#kibaco kill-port

Kill the process listening on a port.

kibaco kill-port 8080 --force