@sundial-ai/cli 0.0.1

package/dist/core/skill-source.js

@@ -0,0 +1,111 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { isShortcut, getShortcutUrl } from '../utils/registry.js';
+/**
+ * Check if input looks like a GitHub URL or reference.
+ * Matches: github.com/user/repo, https://github.com/..., etc.
+ */
+export function isGithubUrl(input) {
+    return input.includes('github.com');
+}
+/**
+ * Normalize a GitHub URL to degit format.
+ * Converts: https://github.com/user/repo/tree/branch/path -> user/repo/path#branch
+ */
+function normalizeGithubUrl(url) {
+    let location = url;
+    // Remove https:// or http:// prefix if present
+    location = location.replace(/^https?:\/\//, '');
+    // Handle github.com/user/repo/tree/branch/path format
+    // Convert to degit format: user/repo/path#branch
+    const treeMatch = location.match(/^github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)$/);
+    if (treeMatch) {
+        const [, user, repo, branch, subpath] = treeMatch;
+        location = `${user}/${repo}/${subpath}#${branch}`;
+    }
+    else {
+        // Simple format: github.com/user/repo -> user/repo
+        location = location.replace(/^github\.com\//, '');
+    }
+    return location;
+}
+/**
+ * Check if input looks like a local file path.
+ * Matches: ./path, ../path, ~/path, /absolute/path
+ */
+export function isLocalPath(input) {
+    // Check if it starts with path indicators
+    if (input.startsWith('./') ||
+        input.startsWith('../') ||
+        input.startsWith('~/') ||
+        input.startsWith('/')) {
+        return true;
+    }
+    // Check if it's an existing path on disk
+    const resolved = path.resolve(input);
+    return fs.pathExistsSync(resolved);
+}
+/**
+ * Resolve a skill input to its source type and location.
+ *
+ * Resolution order:
+ * 1. Check if it's a registered shortcut (e.g., "tinker")
+ * 2. Check if it contains "github.com" (treat as GitHub URL)
+ * 3. Check if it's a valid local path
+ * 4. Otherwise, throw error
+ */
+export function resolveSkillSource(input) {
+    // 1. Check shortcuts first
+    if (isShortcut(input)) {
+        const url = getShortcutUrl(input);
+        return {
+            type: 'shortcut',
+            location: normalizeGithubUrl(url),
+            originalInput: input
+        };
+    }
+    // 2. Check if it's a GitHub URL
+    if (isGithubUrl(input)) {
+        return {
+            type: 'github',
+            location: normalizeGithubUrl(input),
+            originalInput: input
+        };
+    }
+    // 3. Check if it's a local path
+    if (isLocalPath(input)) {
+        // Resolve to absolute path, handling ~
+        let location = input;
+        if (location.startsWith('~/')) {
+            location = path.join(process.env.HOME || '', location.slice(2));
+        }
+        location = path.resolve(location);
+        return {
+            type: 'local',
+            location,
+            originalInput: input
+        };
+    }
+    // 4. Not found
+    throw new Error(`Skill not found: "${input}". Expected a shortcut name, GitHub URL, or local path.`);
+}
+/**
+ * Extract skill name from a source.
+ * For GitHub: last path segment
+ * For local: folder name
+ * For shortcut: the shortcut name itself
+ */
+export function getSkillNameFromSource(source) {
+    if (source.type === 'shortcut') {
+        return source.originalInput;
+    }
+    if (source.type === 'local') {
+        return path.basename(source.location);
+    }
+    // GitHub: extract from path (e.g., "user/repo/skills/tinker#main" -> "tinker")
+    const parts = source.location.split('/');
+    const lastPart = parts[parts.length - 1];
+    // Remove branch suffix if present (e.g., "tinker#main" -> "tinker")
+    return lastPart.split('#')[0];
+}
+//# sourceMappingURL=skill-source.js.map

package/dist/core/skill-source.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

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 all agent folders and packages, or details for a specific skill')
+    .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 } from '../types/index.js';
+/**
+ * Show an interactive checkbox UI for selecting default agents.
+ *
+ * @param currentDefaults - Previously saved defaults (empty on first run)
+ * @returns Array of selected agent flags (e.g., ['claude', 'codex'])
+ *
+ * Behavior:
+ * - Shows all supported agent TYPES from SUPPORTED_AGENTS
+ * - First run (currentDefaults empty): ALL agents are pre-selected
+ * - Subsequent runs: Only previously saved defaults are pre-selected
+ * - Must select at least one agent
+ */
+export declare function promptAgentSelection(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,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,eAAe,GAAE,SAAS,EAAO,GAChC,OAAO,CAAC,SAAS,EAAE,CAAC,CA2BtB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKrE"}

package/dist/utils/prompts.js

@@ -0,0 +1,46 @@
+import { checkbox, confirm } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { SUPPORTED_AGENTS } from '../core/agents.js';
+/**
+ * Show an interactive checkbox UI for selecting default agents.
+ *
+ * @param currentDefaults - Previously saved defaults (empty on first run)
+ * @returns Array of selected agent flags (e.g., ['claude', 'codex'])
+ *
+ * Behavior:
+ * - Shows all supported agent TYPES from SUPPORTED_AGENTS
+ * - First run (currentDefaults empty): ALL agents are pre-selected
+ * - Subsequent runs: Only previously saved defaults are pre-selected
+ * - Must select at least one agent
+ */
+export async function promptAgentSelection(currentDefaults = []) {
+    const isFirstRun = currentDefaults.length === 0;
+    console.log(chalk.gray('Use space to toggle, enter to confirm:\n'));
+    // Build choices from SUPPORTED_AGENTS constants
+    // Show paths so users understand what each agent refers to
+    const choices = SUPPORTED_AGENTS.map(agent => ({
+        name: `${agent.name} (~/${agent.folderName}/ and ./${agent.folderName}/)`,
+        value: agent.flag,
+        // First run: select ALL agents
+        // Otherwise: only select if it was in previous defaults
+        checked: isFirstRun ? true : currentDefaults.includes(agent.flag)
+    }));
+    const selectedAgents = await checkbox({
+        message: 'Select default agents:',
+        choices,
+        required: true,
+        theme: {
+            style: {
+                keysHelpTip: () => undefined
+            }
+        }
+    });
+    return selectedAgents;
+}
+export async function confirmAction(message) {
+    return confirm({
+        message,
+        default: true
+    });
+}
+//# 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,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,kBAA+B,EAAE;IAEjC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;IAEpE,gDAAgD;IAChD,2DAA2D;IAC3D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,WAAW,KAAK,CAAC,UAAU,IAAI;QACzE,KAAK,EAAE,KAAK,CAAC,IAAiB;QAC9B,+BAA+B;QAC/B,wDAAwD;QACxD,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAiB,CAAC;KAC/E,CAAC,CAAC,CAAC;IAEJ,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC;QACpC,OAAO,EAAE,wBAAwB;QACjC,OAAO;QACP,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE;YACL,KAAK,EAAE;gBACL,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;aAC7B;SACF;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,OAAO,OAAO,CAAC;QACb,OAAO;QACP,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,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,42 @@
+{
+  "name": "@sundial-ai/cli",
+  "version": "0.0.1",
+  "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": "./test/run-all.sh"
+  },
+  "keywords": [
+    "cli",
+    "agents",
+    "skills",
+    "claude",
+    "codex",
+    "gemini"
+  ],
+  "author": "Belinda Mo <belinda@sundialscientific.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "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"
+  }
+}

package/src/commands/add.ts

@@ -0,0 +1,136 @@
+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 { 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: show agent type selection dialog
+    const selectedAgents = await promptAgentSelection();
+    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)'));
+    }
+  }
+}