How do I install the Artbot CLI skill?

Run npx skillmds@latest add khazp/artbot-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Artbot CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Artbot CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Artbot CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Artbot CLI?

KhazP (@khazp) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Artbot CLI by khazp — Agent Skill

Name: Artbot CLI
Author: KhazP

Artbot CLI

Use when operating the ArtBot CLI for local backend lifecycle, health checks, run creation, run inspection, replay debugging, review queue work, canaries, cleanup, or command-first automation. Prefer JSON-first commands, explicit subcommands, and non-TUI usage. Relevant terms include ArtBot CLI, artbot doctor, backend status, research artist, research work, runs show, runs watch, replay attempt, review queue, canaries, cleanup, and command-only automation.

KhazP c601112 2 files · 4.0 KB Updated Sep 17, 2026

File contents

ArtBot CLI

Use this skill when you need to operate ArtBot effectively from the command line.

Core Rules

In this repo, prefer pnpm --filter artbot dev -- ....
For installed usage, replace that prefix with artbot ....
Bare artbot opens the interactive UI in an interactive TTY. Use explicit subcommands plus --json for automation.
For agent work, prefer explicit commands and --json or --output-format stream-json.
Keep --no-tui or ARTBOT_NO_TUI=1 available when automation must refuse interactive UI launch.
Interactive setup, TUI launch, auth capture, and local backend start/stop require artbot trust allow for the current workspace.

Decision Tree

If you are not sure whether the environment is healthy:

pnpm --filter artbot dev -- --json doctor
pnpm --filter artbot dev -- --json backend status
pnpm --filter artbot dev -- --json auth list
pnpm --filter artbot dev -- --json auth status
pnpm --filter artbot dev -- trust status

If the machine is not bootstrapped yet or local config is broken:

pnpm --filter artbot dev -- setup

If you want to understand planned sourcing before creating a run:

pnpm --filter artbot dev -- --json research artist --artist "Burhan Dogancay" --preview-only
pnpm --filter artbot dev -- --json research work --artist "Erol Akyavas" --title "Kusatma" --preview-only

If you want the finished terminal payload in one command:

pnpm --filter artbot dev -- --json research artist --artist "Burhan Dogancay" --wait
pnpm --filter artbot dev -- --json research work --artist "Erol Akyavas" --title "Kusatma" --wait

If you already have a run id:

pnpm --filter artbot dev -- --json runs show --run-id <id>
pnpm --filter artbot dev -- --json runs watch --run-id <id> --interval 2
pnpm --filter artbot dev -- --output-format stream-json runs watch --run-id <id>
pnpm --filter artbot dev -- sessions resume

If parsing or acceptance looks wrong, replay stored artifacts before re-running:

pnpm --filter artbot dev -- --json replay attempt --run-id <id>

If a run produced review items or clustering questions:

pnpm --filter artbot dev -- --json review queue --run-id <id>
pnpm --filter artbot dev -- --json review decide --run-id <id> --item-id <item-id> --decision merge
pnpm --filter artbot dev -- --json graph explain --run-id <id> --cluster-id <cluster-id>

If you need smoke checks or retention work:

pnpm --filter artbot dev -- --json canaries run
pnpm --filter artbot dev -- --json canaries history
pnpm --filter artbot dev -- --json cleanup --dry-run

Usage Notes

--json is the default choice when another tool or agent will read the output.
--output-format stream-json is preferred when another tool wants incremental NDJSON lifecycle events.
setup is intentionally interactive; do not use it as a normal health probe.
artbot tui is for humans. Stay in command mode unless the task explicitly calls for the interactive UI.
Respect auth and licensed access boundaries. Do not attempt bypass behavior.
Install this repo skill explicitly by copy or symlink from skills/artbot-cli; package install must not write into agent homes automatically.

---name: artbot-clidescription: Use when operating the ArtBot CLI for local backend lifecycle, health checks, run creation, run inspection, replay debugging, review queue work, canaries, cleanup, or command-first automation. Prefer JSON-first commands, explicit subcommands, and non-TUI usage. Relevant terms include ArtBot CLI, artbot doctor, backend status, research artist, research work, runs show, runs watch, replay attempt, review queue, canaries, cleanup, and command-only automation.---# ArtBot CLIUse this skill when you need to operate ArtBot effectively from the command line.## Core Rules- In this repo, prefer `pnpm --filter artbot dev -- ...`.- For installed usage, replace that prefix with `artbot ...`.- Bare `artbot` opens the interactive UI in an interactive TTY. Use explicit subcommands plus `--json` for automation.- For agent work, prefer explicit commands and `--json` or `--output-format stream-json`.- Keep `--no-tui` or `ARTBOT_NO_TUI=1` available when automation must refuse interactive UI launch.- Interactive setup, TUI launch, auth capture, and local backend start/stop require `artbot trust allow` for the current workspace.## Decision TreeIf you are not sure whether the environment is healthy:```bashpnpm --filter artbot dev -- --json doctorpnpm --filter artbot dev -- --json backend statuspnpm --filter artbot dev -- --json auth listpnpm --filter artbot dev -- --json auth statuspnpm --filter artbot dev -- trust status```If the machine is not bootstrapped yet or local config is broken:```bashpnpm --filter artbot dev -- setup```If you want to understand planned sourcing before creating a run:```bashpnpm --filter artbot dev -- --json research artist --artist "Burhan Dogancay" --preview-onlypnpm --filter artbot dev -- --json research work --artist "Erol Akyavas" --title "Kusatma" --preview-only```If you want the finished terminal payload in one command:```bashpnpm --filter artbot dev -- --json research artist --artist "Burhan Dogancay" --waitpnpm --filter artbot dev -- --json research work --artist "Erol Akyavas" --title "Kusatma" --wait```If you already have a run id:```bashpnpm --filter artbot dev -- --json runs show --run-id <id>pnpm --filter artbot dev -- --json runs watch --run-id <id> --interval 2pnpm --filter artbot dev -- --output-format stream-json runs watch --run-id <id>pnpm --filter artbot dev -- sessions resume```If parsing or acceptance looks wrong, replay stored artifacts before re-running:```bashpnpm --filter artbot dev -- --json replay attempt --run-id <id>```If a run produced review items or clustering questions:```bashpnpm --filter artbot dev -- --json review queue --run-id <id>pnpm --filter artbot dev -- --json review decide --run-id <id> --item-id <item-id> --decision mergepnpm --filter artbot dev -- --json graph explain --run-id <id> --cluster-id <cluster-id>```If you need smoke checks or retention work:```bashpnpm --filter artbot dev -- --json canaries runpnpm --filter artbot dev -- --json canaries historypnpm --filter artbot dev -- --json cleanup --dry-run```## Usage Notes- `--json` is the default choice when another tool or agent will read the output.- `--output-format stream-json` is preferred when another tool wants incremental NDJSON lifecycle events.- `setup` is intentionally interactive; do not use it as a normal health probe.- `artbot tui` is for humans. Stay in command mode unless the task explicitly calls for the interactive UI.- Respect auth and licensed access boundaries. Do not attempt bypass behavior.- Install this repo skill explicitly by copy or symlink from `skills/artbot-cli`; package install must not write into agent homes automatically.

Frequently asked questions