@hesed/claude
v0.1.0
Published
CLI for running Claude agents, skills, and slash commands via the Anthropic Agent SDK
Readme
claude
CLI for running Claude agents, skills, and slash commands via the Anthropic Agent SDK
Install
sdkck plugins install @hesed/claudeUsage
$ npm install -g @hesed/claude
$ claude COMMAND
running command...
$ claude (--version)
@hesed/claude/0.1.0 darwin-arm64 node-v22.14.0
$ claude --help [COMMAND]
USAGE
$ claude COMMAND
...Commands
claude claude ask PROMPTclaude claude auth addclaude claude auth deleteclaude claude auth listclaude claude auth profileclaude claude auth testclaude claude auth updateclaude claude listclaude claude run NAME [INPUT]claude claude workspace addclaude claude workspace defaultclaude claude workspace deleteclaude claude workspace listclaude claude workspace update
claude claude ask PROMPT
Ask the Claude agent a natural-language question
USAGE
$ claude claude ask PROMPT [--allow-tools <value>] [-m <value>] [-p <value>] [--repo <value>] [--stream]
[--system <value>] [--toon] [-w <value>]
ARGUMENTS
PROMPT Natural-language prompt to send to the agent
FLAGS
-m, --model=<value> Model to use (e.g. claude-opus-4-7)
-p, --profile=<value> Authentication profile name
-w, --workspace=<value> Workspace name (uses default workspace if omitted)
--allow-tools=<value> Comma-separated list of tools the agent may use (e.g. Read,Edit,Glob)
--repo=<value> Filter workspace context to this repo name
--stream Stream assistant text as it arrives
--system=<value> Custom system prompt for the agent
--toon Format output as toon
DESCRIPTION
Ask the Claude agent a natural-language question
EXAMPLES
$ claude claude ask "What is the capital of France?"
$ claude claude ask "List files in src" --allow-tools Read,Glob
$ claude claude ask "Summarise changes" --workspace proj01
$ claude claude ask "Review changes" --workspace proj01 --repo repo01See code: src/commands/claude/ask.ts
claude claude auth add
Add Claude Agent SDK authentication
USAGE
$ claude claude auth add [--json] [-p <value>] [-k <value>] [-u <value>] [--opus <value>] [--sonnet <value>]
[--haiku <value>]
FLAGS
-k, --key=<value> Anthropic API key
-p, --profile=<value> Profile name:
-u, --url=<value> Anthropic API base URL (blank for default)
--haiku=<value> Haiku model ID mapping (blank for default)
--opus=<value> Opus model ID mapping (blank for default)
--sonnet=<value> Sonnet model ID mapping (blank for default)
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Add Claude Agent SDK authentication
EXAMPLES
$ claude claude auth add
$ claude claude auth add --profile workSee code: src/commands/claude/auth/add.ts
claude claude auth delete
Delete an authentication profile
USAGE
$ claude claude auth delete -p <value> [--json]
FLAGS
-p, --profile=<value> (required) Profile name to delete
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Delete an authentication profile
EXAMPLES
$ claude claude auth delete --profile work
$ claude claude auth delete --profile defaultSee code: src/commands/claude/auth/delete.ts
claude claude auth list
List authentication profiles
USAGE
$ claude claude auth list [--json]
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
List authentication profiles
EXAMPLES
$ claude claude auth listSee code: src/commands/claude/auth/list.ts
claude claude auth profile
Set or show the default authentication profile
USAGE
$ claude claude auth profile [--json] [--default <value>]
FLAGS
--default=<value> Profile name to set as default
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Set or show the default authentication profile
EXAMPLES
$ claude claude auth profile
$ claude claude auth profile --default workSee code: src/commands/claude/auth/profile.ts
claude claude auth test
Test Claude Agent SDK authentication and connection
USAGE
$ claude claude auth test [--json] [-p <value>]
FLAGS
-p, --profile=<value> Authentication profile name
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Test Claude Agent SDK authentication and connection
EXAMPLES
$ claude claude auth test
$ claude claude auth test --profile workSee code: src/commands/claude/auth/test.ts
claude claude auth update
Update existing Claude Agent SDK authentication
USAGE
$ claude claude auth update [--json] [-p <value>] [-k <value>] [-u <value>] [--opus <value>] [--sonnet <value>]
[--haiku <value>]
FLAGS
-k, --key=<value> Anthropic API key
-p, --profile=<value> Profile name to update (default: "default")
-u, --url=<value> Anthropic API base URL
--haiku=<value> Haiku model ID mapping (blank to clear)
--opus=<value> Opus model ID mapping (blank to clear)
--sonnet=<value> Sonnet model ID mapping (blank to clear)
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Update existing Claude Agent SDK authentication
EXAMPLES
$ claude claude auth update
$ claude claude auth update --profile workSee code: src/commands/claude/auth/update.ts
claude claude list
List skills, slash commands, tools, subagents, and MCP servers the agent can use
USAGE
$ claude claude list [--only <value>] [-p <value>] [--toon]
FLAGS
-p, --profile=<value> Authentication profile name
--only=<value> Comma-separated subset to return (skills|commands|tools|agents|mcpServers)
--toon Format output as toon
DESCRIPTION
List skills, slash commands, tools, subagents, and MCP servers the agent can use
EXAMPLES
$ claude claude list
$ claude claude list --only skills
$ claude claude list --only skills,commands --toonSee code: src/commands/claude/list.ts
claude claude run NAME [INPUT]
Execute a slash command or skill by name
USAGE
$ claude claude run NAME [INPUT] [--allow-tools <value>] [-p <value>] [--stream] [--system <value>] [--toon]
ARGUMENTS
NAME Slash command (e.g. /help) or skill name
[INPUT] Additional input to forward to the agent
FLAGS
-p, --profile=<value> Authentication profile name
--allow-tools=<value> Comma-separated list of tools the agent may use (e.g. Read,Edit,Glob)
--stream Stream assistant text as it arrives
--system=<value> Custom system prompt for the agent
--toon Format output as toon
DESCRIPTION
Execute a slash command or skill by name
EXAMPLES
$ claude claude run /help
$ claude claude run review "this branch"
$ claude claude run /clear --streamSee code: src/commands/claude/run.ts
claude claude workspace add
Add a workspace with named repository directories
USAGE
$ claude claude workspace add [--json] [--repo <value>...] [-w <value>]
FLAGS
-w, --workspace=<value> Workspace name
--repo=<value>... Named repo entry as name=path (repeatable)
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Add a workspace with named repository directories
EXAMPLES
$ claude claude workspace add --workspace proj01 --repo repo01=/path/to/repo01 --repo repo02=/path/to/repo02See code: src/commands/claude/workspace/add.ts
claude claude workspace default
Set or show the default workspace
USAGE
$ claude claude workspace default [--json] [--set <value>]
FLAGS
--set=<value> Workspace name to set as default
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Set or show the default workspace
EXAMPLES
$ claude claude workspace default
$ claude claude workspace default --set proj01See code: src/commands/claude/workspace/default.ts
claude claude workspace delete
Delete a workspace or remove a repo from a workspace
USAGE
$ claude claude workspace delete [--json] [--repo <value>] [-w <value>]
FLAGS
-w, --workspace=<value> Workspace name
--repo=<value> Repo name to remove from the workspace
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Delete a workspace or remove a repo from a workspace
EXAMPLES
$ claude claude workspace delete --workspace proj01
$ claude claude workspace delete --workspace proj01 --repo repo01
$ claude claude workspace delete --repo repo01See code: src/commands/claude/workspace/delete.ts
claude claude workspace list
List workspaces
USAGE
$ claude claude workspace list [--json]
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
List workspaces
EXAMPLES
$ claude claude workspace listSee code: src/commands/claude/workspace/list.ts
claude claude workspace update
Update repositories in an existing workspace
USAGE
$ claude claude workspace update [--json] [--remove-repo <value>...] [--repo <value>...] [-w <value>]
FLAGS
-w, --workspace=<value> Workspace name (default: default workspace)
--remove-repo=<value>... Repo name to remove from the workspace (repeatable)
--repo=<value>... Named repo entry as name=path to add/update (repeatable, merges into existing)
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Update repositories in an existing workspace
EXAMPLES
$ claude claude workspace update --workspace proj01 --repo repo01=/new/path --repo repo03=/path/to/repo03
$ claude claude workspace update --workspace proj01 --remove-repo repo02See code: src/commands/claude/workspace/update.ts
