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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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 helpnookins 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