CLI: Command reference

Complete list of all Sundial CLI commands.

All commands

All commands can be run with npx sundial-hub <command> or, after installing globally with npm install -g sundial-hub, just sundial-hub <command>.

Command	Description
`npx sundial-hub add <skills...>`	Install skill(s) to agent config(s)
`npx sundial-hub remove <skills...>`	Remove skill(s) from agent config(s)
`npx sundial-hub push [dir]`	Publish a skill to the hub
`npx sundial-hub find [query]`	Find and search skills interactively
`npx sundial-hub mine`	List your published skills
`npx sundial-hub installed`	List installed skills per agent
`npx sundial-hub config`	Configure default agents
`npx sundial-hub auth login`	Authenticate via browser or token
`npx sundial-hub auth logout`	Remove stored token
`npx sundial-hub auth status`	Check auth status

add

Terminal

# From the registry
npx sundial-hub add tinker

# From GitHub
npx sundial-hub add github.com/user/repo

# From local path
npx sundial-hub add ./path/to/skill

# Multiple at once
npx sundial-hub add tinker web-search code-review

# Target specific agents
npx sundial-hub add tinker --claude --codex

# Install globally
npx sundial-hub add tinker --global

push

Terminal

# Push from current directory
npx sundial-hub push

# Push from a specific path
npx sundial-hub push ./my-skill

# With all options
npx sundial-hub push --version 2 --changelog "Bug fixes" --visibility private --categories coding

Flag	Description
`--version <ver>`	Version to publish
`--changelog <msg>`	Changelog message
`--visibility <vis>`	public or private
`--categories <cats...>`	Category slugs for new skills

find

Terminal

# Interactive find
npx sundial-hub find

# Search with query
npx sundial-hub find "web search"

auth

Terminal

npx sundial-hub auth login     # Interactive login
npx sundial-hub auth status    # Show current auth
npx sundial-hub auth logout    # Remove stored token

Tokens are stored in ~/.sundial/auth.json. They start with sd_ and are hashed on the server.

Other commands

Terminal

npx sundial-hub installed      # List installed skills per agent
npx sundial-hub mine           # List your published skills on the hub
npx sundial-hub remove tinker  # Remove an installed skill
npx sundial-hub config         # Configure default agents

Agent flags

Flag	Installs to
`--claude`	.claude/skills/
`--codex`	.codex/skills/
`--gemini`	.gemini/skills/
`--global`	~/.<agent>/skills/

Environment variables

Variable	Description	Default
`SUNDIAL_HUB_URL`	Hub API base URL	https://sundialhub.com