AI Agents

Let Claude Code or Codex run, inspect, debug and stop your local services with fuku.

The fuku plugin holds one Agent Skill. It teaches the agent to use the fuku CLI and the REST API.

$ fuku run default -d
 ✔ auth Ready 1.2s
 ✔ api Ready 2.4s
 ✔ web Ready 3.1s

Running detached · pid 76741 · 3 services · 3.1s
API 127.0.0.1:3858

$ fuku logs --tail 100 --no-follow --no-ui api
api │ 10:23:05Z INF server listening on :8080

What the agent does

• Runs fuku in detached mode. fuku run <profile> -d starts the profile in the background and returns once every service runs. The summary names each ready service, the PID and the API address
• Checks the status. fuku doctor <profile> --json reports whether fuku already runs, config errors, missing directories and busy ports. When fuku already runs, the agent attaches to it and never starts a second one
• Manages services. It lists, starts, stops and restarts services through the REST API. The API token never reaches the agent's output
• Reads logs. fuku logs --tail 100 --no-follow --no-ui reads the recent output and exits. No log follower is left behind
• Helps with configuration. Shared changes go to fuku.yaml, local-only ones to fuku.override.yaml. The agent validates the result with fuku doctor and restarts the profile to apply it

Claude Code

claude plugin marketplace add tab/fuku
claude plugin install fuku@fuku

Codex

codex plugin marketplace add tab/fuku
codex plugin add fuku@fuku

The AI Agents plugin page has the requirements, the in-session install, the upgrade commands and every rule the skill follows.