nookins / docs
Command line

nookins workspace

Arguments and options for nookins workspace and its subcommands.

Documentation for Nookins 0.54.2-alpha.1 · Public alpha

Captured from nookins 0.54.2-alpha.1 using help only. Angle-bracket names are required values; square brackets indicate optional input. Substitute your own IDs and paths.

nookins workspace

Inspect and reconcile durable per-agent filesystem workspaces

Usage: nookins workspace [OPTIONS] <COMMAND>

Commands:
  inspect     Inspect the reconciled manifest and recent execution records
  reconcile   Re-scan operator-maintained files and advance the durable manifest
  migrate-id  Move one stopped agent's workspace to a new configured agent ID
  skill       Author, review, install, and assign OpenClaw-style catalog skills
  help        Print this message or the help of the given subcommand(s)

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace inspect

Inspect the reconciled manifest and recent execution records

Usage: nookins workspace inspect [OPTIONS] <AGENT_ID>

Arguments:
  <AGENT_ID>

Options:
      --limit <LIMIT>    [default: 25]
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace reconcile

Re-scan operator-maintained files and advance the durable manifest

Usage: nookins workspace reconcile [OPTIONS] <AGENT_ID>

Arguments:
  <AGENT_ID>

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace migrate-id

Move one stopped agent's workspace to a new configured agent ID

Usage: nookins workspace migrate-id [OPTIONS] <OLD_AGENT_ID> <NEW_AGENT_ID>

Arguments:
  <OLD_AGENT_ID>
  <NEW_AGENT_ID>

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace skill

Author, review, install, and assign OpenClaw-style catalog skills

Usage: nookins workspace skill [OPTIONS] <AGENT_ID> <COMMAND>

Commands:
  list     List catalog skills for the agent's workspace
  show     Show one skill and its current revision
  create   Author a new draft skill from a name, description, and markdown body file
  submit   Submit a draft skill for human approval
  approve  Approve a pending skill (human-in-the-loop gate)
  reject   Reject a pending skill
  install  Install/activate an approved skill
  assign   Assign an installed skill to an agent or agent group
  help     Print this message or the help of the given subcommand(s)

Arguments:
  <AGENT_ID>

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace skill list

List catalog skills for the agent's workspace

Usage: nookins workspace skill <AGENT_ID> list [OPTIONS]

Options:
      --limit <LIMIT>    [default: 50]
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace skill show

Show one skill and its current revision

Usage: nookins workspace skill <AGENT_ID> show [OPTIONS] <SKILL_ID>

Arguments:
  <SKILL_ID>

Options:
      --output <OUTPUT>  Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help             Print help

nookins workspace skill create

Author a new draft skill from a name, description, and markdown body file

Usage: nookins workspace skill <AGENT_ID> create [OPTIONS] --description <DESCRIPTION> --body-file <BODY_FILE> <NAME>

Arguments:
  <NAME>

Options:
      --description <DESCRIPTION>
      --body-file <BODY_FILE>      Path to a markdown file containing the skill body
      --tool <TOOLS>               Permitted tool paths (repeatable)
      --submit                     Immediately submit the draft for approval
      --output <OUTPUT>            Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help                       Print help

nookins workspace skill submit

Submit a draft skill for human approval

Usage: nookins workspace skill <AGENT_ID> submit [OPTIONS] --revision <REVISION> <SKILL_ID>

Arguments:
  <SKILL_ID>

Options:
      --revision <REVISION>  Exact revision ID returned by skill show; never approve an unseen later edit
      --output <OUTPUT>      Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help                 Print help

nookins workspace skill approve

Approve a pending skill (human-in-the-loop gate)

Usage: nookins workspace skill <AGENT_ID> approve [OPTIONS] --revision <REVISION> <SKILL_ID>

Arguments:
  <SKILL_ID>

Options:
      --revision <REVISION>  Exact revision ID returned by skill show; never approve an unseen later edit
      --output <OUTPUT>      Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help                 Print help

nookins workspace skill reject

Reject a pending skill

Usage: nookins workspace skill <AGENT_ID> reject [OPTIONS] --revision <REVISION> <SKILL_ID>

Arguments:
  <SKILL_ID>

Options:
      --revision <REVISION>  Exact revision ID returned by skill show; never approve an unseen later edit
      --output <OUTPUT>      Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help                 Print help

nookins workspace skill install

Install/activate an approved skill

Usage: nookins workspace skill <AGENT_ID> install [OPTIONS] --revision <REVISION> <SKILL_ID>

Arguments:
  <SKILL_ID>

Options:
      --revision <REVISION>  Exact revision ID returned by skill show; never approve an unseen later edit
      --output <OUTPUT>      Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help                 Print help

nookins workspace skill assign

Assign an installed skill to an agent or agent group

Usage: nookins workspace skill <AGENT_ID> assign [OPTIONS] --revision <REVISION> <SKILL_ID> <TARGET_KIND> <TARGET_ID>

Arguments:
  <SKILL_ID>
  <TARGET_KIND>  "agent" or "group"
  <TARGET_ID>

Options:
      --revision <REVISION>
          Exact approved active revision to assign
      --group-revision <GROUP_REVISION>
          Exact membership revision from the group directory; required for groups
      --output <OUTPUT>
          Select stable human output or the versioned machine envelope [default: human] [possible values: human, json]
  -h, --help
          Print help

On this page