CLI: Getting started

Install the Sundial CLI and start using skills in 30 seconds.

Install

Terminal

npm install -g sundial-hub

Requires Node.js 18+. Or use npx sundial-hub without installing.

Add a skill

Terminal

# From the registry
npx sundial-hub add tinker

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

# From a local folder
npx sundial-hub add ./my-local-skill

Skills are installed to your agent's config folder (.claude/skills/, .codex/skills/, or .gemini/skills/). If a local project folder is detected, the skill is added there. Otherwise it's added globally to ~/.

Search for skills

Terminal

# Interactive find
npx sundial-hub find

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

Publish a skill

Create a folder with a SKILL.md, then push:

my-skill/SKILL.md

---
name: my-skill
description: What this skill does.
version: 1
---

# My Skill

Instructions the agent follows when this skill is active.

Terminal

cd my-skill
npx sundial-hub auth login
npx sundial-hub push .

The CLI will ask for categories and visibility on first push. On subsequent pushes, it reads the version from your frontmatter. See Push & publish for the full workflow.

Authentication

You need to authenticate to publish skills. Two options:

Terminal

# Option 1: Browser login (recommended)
npx sundial-hub auth login
# → select "Log in with browser" → authorize in browser → done

# Option 2: Paste a token
# Go to sundialhub.com/settings → Create token → paste it
npx sundial-hub auth login
# → select "Paste an API token" → paste

You don't need to authenticate to add or find skills — only to publish.