@sundial-ai/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { SUPPORTED_AGENTS } from './core/agents.js';
+import { addCommand } from './commands/add.js';
+import { removeCommand } from './commands/remove.js';
+import { listCommand } from './commands/list.js';
+import { showCommand } from './commands/show.js';
+import { configCommand } from './commands/config.js';
+import { suggestCommand, getValidCommands } from './utils/fuzzy-match.js';
+const program = new Command();
+program
+    .name('sun')
+    .description('Sundial CLI - Manage skills for your AI agents')
+    .version('0.1.0');
+// Add command
+const add = program
+    .command('add <skills...>')
+    .description('Add skill(s) to agent configuration(s)')
+    .option('--global', 'Install to global agent config (~/.claude/, ~/.codex/, etc.)');
+// Add agent flags dynamically
+for (const agent of SUPPORTED_AGENTS) {
+    add.option(`--${agent.flag}`, `Install to ${agent.name}`);
+}
+add.action(async (skills, options) => {
+    try {
+        await addCommand(skills, options);
+    }
+    catch (error) {
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// Remove command
+const remove = program
+    .command('remove <skills...>')
+    .description('Remove skill(s) from agent configuration(s)')
+    .option('--global', 'Remove from global config');
+for (const agent of SUPPORTED_AGENTS) {
+    remove.option(`--${agent.flag}`, `Remove from ${agent.name}`);
+}
+remove.action(async (skills, options) => {
+    try {
+        await removeCommand(skills, options);
+    }
+    catch (error) {
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// List command
+program
+    .command('list')
+    .description('List all installed skills for each agent')
+    .action(async () => {
+    try {
+        await listCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// Show command
+program
+    .command('show <skill>')
+    .description('Show skill details and installation locations')
+    .action(async (skill) => {
+    try {
+        await showCommand(skill);
+    }
+    catch (error) {
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// Config command
+program
+    .command('config')
+    .description('Configure default agents')
+    .action(async () => {
+    try {
+        await configCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// Handle unknown commands with fuzzy matching
+program.on('command:*', (operands) => {
+    const unknownCommand = operands[0];
+    const suggestion = suggestCommand(unknownCommand);
+    console.error(chalk.red(`Error: Unknown command '${unknownCommand}'`));
+    if (suggestion) {
+        console.error(chalk.yellow(`Did you mean '${suggestion}'?`));
+    }
+    console.error();
+    console.error(`Valid commands: ${getValidCommands().join(', ')}`);
+    process.exit(1);
+});
+// Parse and execute
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,57 @@
+export type AgentType = 'claude' | 'codex' | 'gemini';
+export interface AgentConfig {
+    name: string;
+    flag: string;
+    folderName: string;
+}
+export interface SunConfig {
+    defaultAgents: AgentType[];
+    firstRunComplete: boolean;
+    skillRegistryUrl?: string;
+}
+/**
+ * Skill metadata parsed from SKILL.md frontmatter.
+ * Per spec: https://agentskills.io/specification#skill-md-format
+ */
+export interface SkillMetadata {
+    /** Required: Max 64 chars, lowercase letters, numbers, hyphens only */
+    name: string;
+    /** Required: Max 1024 chars, describes what the skill does */
+    description: string;
+    /** Optional: License name or reference to bundled license file */
+    license?: string;
+    /** Optional: Max 500 chars, environment requirements */
+    compatibility?: string;
+    /** Optional: Arbitrary key-value mapping (includes author, version, etc.) */
+    metadata?: Record<string, string>;
+    /** Optional: Space-delimited list of pre-approved tools (experimental) */
+    allowedTools?: string;
+}
+export type SkillSourceType = 'shortcut' | 'github' | 'local';
+/** Used at install time to determine how to fetch a skill */
+export interface SkillSource {
+    type: SkillSourceType;
+    /** The resolved location (URL for github/shortcut, path for local) */
+    location: string;
+    /** Original input string from user (e.g., "tinker" or "github.com/user/skill") */
+    originalInput: string;
+}
+export interface SkillInstallation {
+    agent: AgentType;
+    path: string;
+    isGlobal: boolean;
+    metadata: SkillMetadata;
+    contentHash: string;
+}
+export interface CommandFlags {
+    global?: boolean;
+    claude?: boolean;
+    codex?: boolean;
+    gemini?: boolean;
+}
+export interface DetectedAgent {
+    agent: AgentConfig;
+    path: string;
+    isGlobal: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9D,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/fuzzy-match.d.ts

@@ -0,0 +1,16 @@
+export interface FuzzyMatch {
+    command: string;
+    score: number;
+}
+/**
+ * Find the closest matching command using fuzzy search.
+ * fuzzysort scores: 0 = perfect match, negative = worse match
+ */
+export declare function findClosestCommand(input: string): FuzzyMatch | null;
+/**
+ * Suggest a command if the input is close enough to a valid command.
+ * Returns null if no good suggestion (avoids suggesting "add" for "xyz").
+ */
+export declare function suggestCommand(input: string): string | null;
+export declare function getValidCommands(): string[];
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/utils/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../src/utils/fuzzy-match.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAenE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS3D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist/utils/fuzzy-match.js

@@ -0,0 +1,37 @@
+import fuzzysort from 'fuzzysort';
+const VALID_COMMANDS = ['add', 'remove', 'list', 'show', 'config'];
+/**
+ * Find the closest matching command using fuzzy search.
+ * fuzzysort scores: 0 = perfect match, negative = worse match
+ */
+export function findClosestCommand(input) {
+    const results = fuzzysort.go(input, VALID_COMMANDS, {
+        // Allow any match (we'll filter by score later)
+        threshold: -Infinity
+    });
+    if (results.length === 0) {
+        return null;
+    }
+    const best = results[0];
+    return {
+        command: best.target,
+        score: best.score
+    };
+}
+/**
+ * Suggest a command if the input is close enough to a valid command.
+ * Returns null if no good suggestion (avoids suggesting "add" for "xyz").
+ */
+export function suggestCommand(input) {
+    const match = findClosestCommand(input);
+    // Only suggest if score is reasonable (0=perfect, -100 is still decent for typos)
+    // Examples: "ad" -> "add" (good), "addd" -> "add" (good), "xyz" -> null (no suggestion)
+    if (match && match.score > -100) {
+        return match.command;
+    }
+    return null;
+}
+export function getValidCommands() {
+    return [...VALID_COMMANDS];
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/utils/fuzzy-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.js","sourceRoot":"","sources":["../../src/utils/fuzzy-match.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAOnE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE;QAClD,gDAAgD;QAChD,SAAS,EAAE,CAAC,QAAQ;KACrB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAExC,kFAAkF;IAClF,wFAAwF;IACxF,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/prompts.d.ts

@@ -0,0 +1,16 @@
+import type { AgentType, DetectedAgent } from '../types/index.js';
+/**
+ * Show an interactive checkbox UI for selecting default agents.
+ *
+ * @param detectedAgents - Agents found in local/global directories
+ * @param currentDefaults - Previously saved defaults (empty on first run)
+ * @returns Array of selected agent flags (e.g., ['claude', 'codex'])
+ *
+ * Behavior:
+ * - First run (currentDefaults empty): ALL detected agents are pre-selected
+ * - Subsequent runs: Only previously saved defaults are pre-selected
+ * - If no agents detected: Show all supported agents (none pre-selected)
+ */
+export declare function promptAgentSelection(detectedAgents: DetectedAgent[], currentDefaults?: AgentType[]): Promise<AgentType[]>;
+export declare function confirmAction(message: string): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,aAAa,EAAE,EAC/B,eAAe,GAAE,SAAS,EAAO,GAChC,OAAO,CAAC,SAAS,EAAE,CAAC,CA2DtB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrE"}

package/dist/utils/prompts.js

@@ -0,0 +1,80 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { SUPPORTED_AGENTS, getSupportedAgentsMessage } from '../core/agents.js';
+/**
+ * Show an interactive checkbox UI for selecting default agents.
+ *
+ * @param detectedAgents - Agents found in local/global directories
+ * @param currentDefaults - Previously saved defaults (empty on first run)
+ * @returns Array of selected agent flags (e.g., ['claude', 'codex'])
+ *
+ * Behavior:
+ * - First run (currentDefaults empty): ALL detected agents are pre-selected
+ * - Subsequent runs: Only previously saved defaults are pre-selected
+ * - If no agents detected: Show all supported agents (none pre-selected)
+ */
+export async function promptAgentSelection(detectedAgents, currentDefaults = []) {
+    const isFirstRun = currentDefaults.length === 0;
+    // Show what we detected
+    if (detectedAgents.length > 0) {
+        console.log(chalk.cyan(`\nWe detected ${detectedAgents.length} agent folders installed on your machine:`));
+        for (const detected of detectedAgents) {
+            const location = detected.isGlobal ? '~/' : './';
+            console.log(chalk.white(`  • ${detected.agent.name} ${chalk.gray(`(${location}${detected.agent.folderName})`)}`));
+        }
+        console.log();
+    }
+    console.log(chalk.gray(getSupportedAgentsMessage()));
+    console.log(chalk.gray('Select which agents you want to add skills to by default:\n'));
+    // Build choices from detected agents
+    const choices = detectedAgents.map(detected => {
+        const location = detected.isGlobal ? '(global)' : '(local)';
+        const agentFlag = detected.agent.flag;
+        return {
+            name: `${detected.agent.name} ${chalk.gray(location)}`,
+            value: agentFlag,
+            // First run: select ALL detected agents
+            // Otherwise: only select if it was in previous defaults
+            checked: isFirstRun ? true : currentDefaults.includes(agentFlag)
+        };
+    });
+    // If no agents detected, show all supported agents as options
+    if (choices.length === 0) {
+        console.log(chalk.yellow('No agent folders detected on your machine.'));
+        console.log(chalk.gray('Showing all supported agents - select which ones you plan to use:\n'));
+        for (const agent of SUPPORTED_AGENTS) {
+            choices.push({
+                name: agent.name,
+                value: agent.flag,
+                checked: false // None pre-selected since we don't know which they'll install
+            });
+        }
+    }
+    const { selectedAgents } = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'selectedAgents',
+            message: 'Select default agents:',
+            choices,
+            validate: (answer) => {
+                if (answer.length === 0) {
+                    return 'You must select at least one agent.';
+                }
+                return true;
+            }
+        }
+    ]);
+    return selectedAgents;
+}
+export async function confirmAction(message) {
+    const { confirmed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message,
+            default: true
+        }
+    ]);
+    return confirmed;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,cAA+B,EAC/B,kBAA+B,EAAE;IAEjC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IAEhD,wBAAwB;IACxB,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,cAAc,CAAC,MAAM,2CAA2C,CAAC,CAAC,CAAC;QAC3G,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACpH,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC,CAAC;IAEvF,qCAAqC;IACrC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;QAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAiB,CAAC;QAEnD,OAAO;YACL,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACtD,KAAK,EAAE,SAAS;YAChB,wCAAwC;YACxC,wDAAwD;YACxD,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;SACjE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC,CAAC;QAC/F,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,IAAiB;gBAC9B,OAAO,EAAE,KAAK,CAAC,8DAA8D;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC/C;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,wBAAwB;YACjC,OAAO;YACP,QAAQ,EAAE,CAAC,MAAmB,EAAE,EAAE;gBAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,qCAAqC,CAAC;gBAC/C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC1C;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW;YACjB,OAAO;YACP,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/registry.d.ts

@@ -0,0 +1,6 @@
+/** Skill shortcuts registry - maps short names to GitHub URLs */
+export declare const SKILL_SHORTCUTS: Record<string, string>;
+export declare function isShortcut(skill: string): boolean;
+export declare function getShortcutUrl(skill: string): string | undefined;
+export declare function listShortcuts(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/utils/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/utils/registry.js

@@ -0,0 +1,14 @@
+/** Skill shortcuts registry - maps short names to GitHub URLs */
+export const SKILL_SHORTCUTS = {
+    tinker: 'https://github.com/sundial-org/skills/tree/main/skills/tinker'
+};
+export function isShortcut(skill) {
+    return skill in SKILL_SHORTCUTS;
+}
+export function getShortcutUrl(skill) {
+    return SKILL_SHORTCUTS[skill];
+}
+export function listShortcuts() {
+    return Object.keys(SKILL_SHORTCUTS);
+}
+//# sourceMappingURL=registry.js.map

package/dist/utils/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,MAAM,EAAE,+DAA+D;CACxE,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,IAAI,eAAe,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sundial-ai/cli",
+  "version": "0.1.0",
+  "description": "Customize your agent's skills",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "sun": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "cli",
+    "agents",
+    "skills",
+    "claude",
+    "codex",
+    "gemini"
+  ],
+  "author": "Belinda Mo <belinda@sundialscientific.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "degit": "^2.8.4",
+    "fs-extra": "^11.2.0",
+    "fuzzysort": "^3.0.2",
+    "inquirer": "^9.3.7",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}

package/publish.sh

@@ -0,0 +1,2 @@
+npm config set //registry.npmjs.org/:_authToken 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
+npm publish --access public

package/src/commands/add.ts

@@ -0,0 +1,137 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getAgentByFlag, SUPPORTED_AGENTS } from '../core/agents.js';
+import { isFirstRun, getDefaultAgents, setDefaultAgents } from '../core/config-manager.js';
+import { detectAllAgents, detectLocalAgents } from '../core/agent-detect.js';
+import { installSkill } from '../core/skill-install.js';
+import { promptAgentSelection } from '../utils/prompts.js';
+import type { AgentType, CommandFlags } from '../types/index.js';
+
+/**
+ * Determine which agents to install to and whether to install globally.
+ *
+ * Logic:
+ * 1. If --global flag is set, always install globally
+ * 2. If agent flags (--claude, --codex, etc.) are set, use those agents
+ * 3. If first run, detect agents and prompt for selection
+ * 4. Otherwise use saved default agents
+ *
+ * For local vs global:
+ * - If --global: always global
+ * - Otherwise: check if any configured agents have local folders
+ *   - If yes: install locally to those
+ *   - If no local folders exist for configured agents: install globally
+ */
+async function resolveTargetAgents(flags: CommandFlags): Promise<{ agents: AgentType[]; isGlobal: boolean }> {
+  const forceGlobal = flags.global ?? false;
+
+  // Check if any agent flags were explicitly set
+  const explicitAgents: AgentType[] = [];
+  for (const agent of SUPPORTED_AGENTS) {
+    if (flags[agent.flag as keyof CommandFlags]) {
+      explicitAgents.push(agent.flag as AgentType);
+    }
+  }
+
+  let targetAgents: AgentType[];
+
+  // Determine which agents to target
+  if (explicitAgents.length > 0) {
+    targetAgents = explicitAgents;
+  } else if (await isFirstRun()) {
+    // First run: detect agents and show selection dialog
+    const detectedAgents = await detectAllAgents();
+    const selectedAgents = await promptAgentSelection(detectedAgents);
+    await setDefaultAgents(selectedAgents);
+    targetAgents = selectedAgents;
+  } else {
+    // Use saved defaults
+    const defaultAgents = await getDefaultAgents();
+    if (defaultAgents.length === 0) {
+      throw new Error('No default agents configured. Run "sun config" to set up your agents.');
+    }
+    targetAgents = defaultAgents;
+  }
+
+  // Determine if we should install globally or locally
+  if (forceGlobal) {
+    return { agents: targetAgents, isGlobal: true };
+  }
+
+  // Check if any of the target agents have local folders in current directory
+  const localAgents = await detectLocalAgents();
+  const localAgentFlags = new Set(localAgents.map(a => a.agent.flag));
+
+  const hasLocalFolders = targetAgents.some(agentFlag => localAgentFlags.has(agentFlag));
+
+  // If no local folders exist for any configured agent, install globally
+  const isGlobal = !hasLocalFolders;
+
+  return { agents: targetAgents, isGlobal };
+}
+
+export interface AddResult {
+  skill: string;
+  installedNames: string[];
+  agents: string[];
+  isGlobal: boolean;
+  error?: string;
+}
+
+/**
+ * Add skill(s) to agent configuration(s).
+ */
+export async function addCommand(skills: string[], flags: CommandFlags): Promise<void> {
+  if (skills.length === 0) {
+    console.error(chalk.red('Error: No skills specified. Usage: sun add <skill> [skill2] ...'));
+    process.exit(1);
+  }
+
+  // Resolve target agents
+  const { agents, isGlobal } = await resolveTargetAgents(flags);
+
+  const results: AddResult[] = [];
+
+  for (const skill of skills) {
+    const spinner = ora(`Adding ${skill}...`).start();
+
+    const result: AddResult = {
+      skill,
+      installedNames: [],
+      agents: [],
+      isGlobal
+    };
+
+    try {
+      // Install to each target agent
+      for (const agentFlag of agents) {
+        const { skillNames } = await installSkill(skill, agentFlag, isGlobal);
+        result.installedNames = skillNames;
+        result.agents.push(getAgentByFlag(agentFlag)!.name);
+      }
+
+      spinner.succeed(`Added ${result.installedNames.join(', ')}`);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      result.error = message;
+      spinner.fail(`Failed to add ${skill}: ${message}`);
+    }
+
+    results.push(result);
+  }
+
+  // Print summary
+  const successful = results.filter(r => !r.error);
+  if (successful.length > 0) {
+    const allSkills = [...new Set(successful.flatMap(r => r.installedNames))];
+    const agentFolders = [...new Set(successful.flatMap(r => r.agents))];
+
+    console.log();
+    const location = isGlobal ? '(global)' : '(local)';
+    console.log(chalk.green(`Added ${allSkills.join(', ')} to ${agentFolders.join(' and ')} ${chalk.gray(location)}`));
+
+    if (!isGlobal) {
+      console.log(chalk.gray('(use --global to install globally)'));
+    }
+  }
+}

package/src/commands/config.ts

@@ -0,0 +1,49 @@
+import chalk from 'chalk';
+import { getSupportedAgentsMessage, SUPPORTED_AGENTS } from '../core/agents.js';
+import { loadConfig, setDefaultAgents, getConfigPath } from '../core/config-manager.js';
+import { detectAllAgents } from '../core/agent-detect.js';
+import { promptAgentSelection } from '../utils/prompts.js';
+
+/**
+ * Re-open agent selection dialog and update config.
+ */
+export async function configCommand(): Promise<void> {
+  const config = await loadConfig();
+
+  console.log(chalk.cyan('Sundial CLI Configuration'));
+  console.log(chalk.gray(`Config file: ${getConfigPath()}`));
+  console.log();
+
+  // Show current defaults
+  if (config.defaultAgents.length > 0) {
+    console.log('Current default agents:');
+    for (const agentFlag of config.defaultAgents) {
+      const agent = SUPPORTED_AGENTS.find(a => a.flag === agentFlag);
+      if (agent) {
+        console.log(`  - ${agent.name}`);
+      }
+    }
+    console.log();
+  }
+
+  console.log(chalk.gray(getSupportedAgentsMessage()));
+  console.log();
+
+  // Detect agents and show selection dialog
+  const detectedAgents = await detectAllAgents();
+  const selectedAgents = await promptAgentSelection(detectedAgents, config.defaultAgents);
+
+  await setDefaultAgents(selectedAgents);
+
+  console.log();
+  console.log(chalk.green('Configuration saved!'));
+
+  // Show new defaults
+  console.log('New default agents:');
+  for (const agentFlag of selectedAgents) {
+    const agent = SUPPORTED_AGENTS.find(a => a.flag === agentFlag);
+    if (agent) {
+      console.log(`  - ${agent.name}`);
+    }
+  }
+}