메뉴
Use when running the Bun-backed Paw CLI: local health, active context, shell completions, output modes, profiles, and verification of the supported command surface.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when changing, extending, testing, or reviewing the Bun-backed Paw CLI package and its generated agent skills.
Use when writing or reviewing Pawrrtal Effect TypeScript code in backend-ts: API contracts, HttpApi handlers, services, repos, layers, tagged errors, Effect tests, streams, SQL, auth middleware, or vendor-source API checks.
Turn a bad or long Pawrrtal work session into durable project learning. Use when the user says $retro, asks to learn from a session, says too much went wrong, or asks to create/update skills or rules from recent failures.
Use when touching Pawrrtal channels, providers, tools, plugins, subagents, context providers, turn orchestration, or code that decides where an integration should live. Enforces the split between generic kernel code, manifest plugins, trusted runtime adapters, provider adapters, channel adapters, and agent runtime primitives.
Operate Pawrrtal as a live service: prove the running commit, local origins, Cloudflared public URL, database schema, Telegram channel, and shutdown state. Use when checking whether Pawrrtal is live, deployed, reachable, healthy, broken in Telegram, safe to restart, or safe to take down.
Apply Pawrrtal-specific taste rules for clean modern UX, CLI output, Telegram rendering, and agent/tool presentation. Use when changing UI copy, visual polish, CLI labels, Telegram flow output, tool names, folder/file listings, thinking/tool rendering, or when generalizing user feedback into repo conventions.
| name | paw |
| description | Use when running the Bun-backed Paw CLI: local health, active context, shell completions, output modes, profiles, and verification of the supported command surface. |
| paths | ["packages/paw-cli/**","scripts/paw","justfile","specs/004-effect-paw-cli/**","specs/005-effect-cli-boundaries/**","specs/006-claude-agent-session-engine/**"] |
Use paw when you need the supported Pawrrtal CLI surface. This CLI is a Bun-backed Effect v4 package at packages/paw-cli; do not route new work through the deleted Python CLI.
| Command | Aliases | Summary |
|---|---|---|
paw doctor | - | Check local Paw CLI readiness |
paw context | whoami | Print the active CLI context without secrets |
paw completions <shell> | - | Generate shell completions |
just paw --help
just paw doctor --json
just paw context --json
just paw whoami --plain
just paw completions zsh
bun run --filter @pawrrtal/cli start -- doctor
| Option | Meaning |
|---|---|
-h, --help | Print help for the current command path |
-V, --version | Print CLI version |
-v, --verbose | Print expanded diagnostics and source chains |
--profile | Run this invocation against a specific profile |
--backend-url | Run this invocation against a specific backend target |
--json prints schema-validated command data to stdout.--plain prints tab-separated rows to stdout when a command supports it.--json and --plain are mutually exclusive.PAW_HOME: Override the CLI state root for config and cache.PAW_PROFILE: Set the active profile when --profile is not supplied.PAW_BACKEND_URL: Override the backend target for this invocation.XDG_CONFIG_HOME: Fallback config root when PAW_HOME is unset.XDG_CACHE_HOME: Fallback cache root when PAW_HOME is unset.| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Internal, local, or config error |
| 2 | Usage, validation, or ambiguous input source |
| 5 | Backend, network, external process, or dependency failure |
bun run --filter @pawrrtal/cli typecheck
bun run --filter @pawrrtal/cli test
bun run --filter @pawrrtal/cli check
bun run skill-gen:check
just paw-cli-check
-V prints the CLI version; -v enables verbose diagnostics.PAW_HOME overrides both config and cache roots for the invocation.paw context --json reports source labels such as flag, env:PAW_PROFILE, project:<path>, user:<path>, home-default, and unset.paw context and paw whoami must not print secret values.paw doctor is local-only in this slice and may warn when optional state has not been generated yet.