@tc9011/skills-manager 0.1.0

package/README.md

@@ -0,0 +1,231 @@
+# skills-manager
+
+A CLI companion to [vercel-labs/skills](https://github.com/vercel-labs/skills) that backs up your AI agent skills to GitHub and restores them with automatic agent symlink creation.
+
+## Why
+
+`vercel-labs/skills` installs and manages skills, but it doesn't handle:
+
+- **Backup** — pushing your `~/.agents/` directory (skills + lock file) to a remote GitHub repo
+- **Restore** — cloning skills back on a new machine
+- **Agent linking** — reading `.skill-lock.json` and creating symlinks to every agent you use
+
+`skills-manager` fills that gap. It backs up the entire `~/.agents/` directory (including `.skill-lock.json` and `skills/`), reads the lock file that `vercel-labs/skills` owns (never modifies it), and creates relative symlinks from each agent's skills directory back to the canonical `~/.agents/skills/` source.
+
+## Quick Start
+
+```bash
+# 1. Backup skills to GitHub
+skills-manager push
+
+# 2. Restore skills on a new machine
+skills-manager pull --repo owner/my-skills
+
+# 3. Link skills to your agents (auto-runs after pull)
+skills-manager link
+```
+
+## Commands
+
+### `push`
+
+Commits and pushes the contents of `~/.agents/` (skills + `.skill-lock.json`) to its configured GitHub remote.
+
+```bash
+skills-manager push
+skills-manager push -m "add new debugging skill"
+```
+
+| Option | Description |
+|--------|-------------|
+| `-m, --message <msg>` | Custom commit message (default: auto-generated) |
+
+**Prerequisites**: The `~/.agents/` directory must be a git repository with a remote configured.
+
+### `pull`
+
+Clones or pulls the `~/.agents/` directory from GitHub, then automatically runs `link`.
+
+```bash
+skills-manager pull --repo tc9011/my-skills
+skills-manager pull                          # uses existing remote
+skills-manager pull --skip-link              # pull only, don't link
+```
+
+| Option | Description |
+|--------|-------------|
+| `-r, --repo <owner/name>` | GitHub repo to pull from (default: existing remote) |
+| `--skip-link` | Skip automatic agent linking after pull |
+
+### `link`
+
+Reads `~/.agents/.skill-lock.json` (owned by `vercel-labs/skills`) and creates relative symlinks from each agent's global skills directory to the canonical `~/.agents/skills/`.
+
+```bash
+skills-manager link
+skills-manager link --agents cursor opencode claude-code
+```
+
+| Option | Description |
+|--------|-------------|
+| `-a, --agents <ids...>` | Agent IDs to link (default: `lastSelectedAgents` from lock file) |
+
+**Interactive**: Presents a multiselect prompt with all `lastSelectedAgents` pre-selected. You can deselect agents you don't want to link.
+
+**Symlink model**:
+
+```
+~/.config/opencode/skills/my-skill → ../../../.agents/skills/my-skill   (relative)
+~/.claude/skills/my-skill          → ../../.agents/skills/my-skill      (relative)
+```
+
+## Authentication
+
+Token resolution order:
+
+1. `gh auth token` — GitHub CLI (preferred)
+2. `$GITHUB_TOKEN` environment variable
+3. `$GH_TOKEN` environment variable
+
+If none found, `push` and `pull` will fail with a clear error message. `link` does not require authentication.
+
+## Supported Agents
+
+### Universal Agents (share `.agents/skills`)
+
+| Agent | ID | Global Path |
+|-------|----|-------------|
+| Amp | `amp` | `~/.config/agents/skills` |
+| Cline | `cline` | `~/.agents/skills` |
+| Codex | `codex` | `$CODEX_HOME/skills` |
+| Cursor | `cursor` | `~/.cursor/skills` |
+| Gemini CLI | `gemini-cli` | `~/.gemini/skills` |
+| GitHub Copilot | `github-copilot` | `~/.copilot/skills` |
+| Kimi Code CLI | `kimi-cli` | `~/.config/agents/skills` |
+| OpenCode | `opencode` | `$XDG_CONFIG_HOME/opencode/skills` |
+| Replit | `replit` | `~/.config/agents/skills` |
+| Universal | `universal` | `~/.config/agents/skills` |
+
+### Non-Universal Agents (agent-specific paths)
+
+| Agent | ID | Global Path |
+|-------|----|-------------|
+| AdaL | `adal` | `~/.adal/skills` |
+| Antigravity | `antigravity` | `~/.gemini/antigravity/skills` |
+| Augment | `augment` | `~/.augment/skills` |
+| Claude Code | `claude-code` | `$CLAUDE_CONFIG_DIR/skills` |
+| CodeBuddy | `codebuddy` | `~/.codebuddy/skills` |
+| Command Code | `command-code` | `~/.commandcode/skills` |
+| Continue | `continue` | `~/.continue/skills` |
+| Cortex Code | `cortex` | `~/.snowflake/cortex/skills` |
+| Crush | `crush` | `~/.config/crush/skills` |
+| Droid | `droid` | `~/.factory/skills` |
+| Goose | `goose` | `~/.config/goose/skills` |
+| iFlow CLI | `iflow-cli` | `~/.iflow/skills` |
+| Junie | `junie` | `~/.junie/skills` |
+| Kilo Code | `kilo` | `~/.kilocode/skills` |
+| Kiro CLI | `kiro-cli` | `~/.kiro/skills` |
+| Kode | `kode` | `~/.kode/skills` |
+| MCPJam | `mcpjam` | `~/.mcpjam/skills` |
+| Mistral Vibe | `mistral-vibe` | `~/.vibe/skills` |
+| Mux | `mux` | `~/.mux/skills` |
+| Neovate | `neovate` | `~/.neovate/skills` |
+| OpenClaw | `openclaw` | `~/.openclaw/skills` |
+| OpenHands | `openhands` | `~/.openhands/skills` |
+| Pi | `pi` | `~/.pi/agent/skills` |
+| Pochi | `pochi` | `~/.pochi/skills` |
+| Qoder | `qoder` | `~/.qoder/skills` |
+| Qwen Code | `qwen-code` | `~/.qwen/skills` |
+| Replit | `replit` | `~/.config/agents/skills` |
+| Roo Code | `roo` | `~/.roo/skills` |
+| Trae | `trae` | `~/.trae/skills` |
+| Trae CN | `trae-cn` | `~/.trae-cn/skills` |
+| Windsurf | `windsurf` | `~/.codeium/windsurf/skills` |
+| Zencoder | `zencoder` | `~/.zencoder/skills` |
+
+**41 agents total** — matching the full [vercel-labs/skills](https://github.com/vercel-labs/skills) agent registry.
+
+## Environment Variables
+
+| Variable | Used By | Default |
+|----------|---------|---------|
+| `$GITHUB_TOKEN` | `push`, `pull` | — |
+| `$GH_TOKEN` | `push`, `pull` | — |
+| `$XDG_CONFIG_HOME` | `opencode`, `amp`, `kimi-cli`, `replit`, `universal` | `~/.config` |
+| `$CODEX_HOME` | `codex` | `~/.codex` |
+| `$CLAUDE_CONFIG_DIR` | `claude-code` | `~/.claude` |
+
+## Development
+
+### Prerequisites
+
+- Node.js ≥ 20
+- GitHub CLI (`gh`) for authentication (recommended)
+
+### Local Debugging
+
+```bash
+# Run any command directly with tsx (no build step needed)
+npx tsx src/index.ts push
+npx tsx src/index.ts pull --repo owner/my-skills
+npx tsx src/index.ts link
+npx tsx src/index.ts link --agents cursor opencode
+
+# Or use the dev script (same thing)
+npm run dev -- push
+npm run dev -- link -- --agents cursor
+```
+
+To simulate a real global install:
+
+```bash
+npm link                        # register skills-manager globally
+skills-manager push             # use it like an end user
+npm unlink -g skills-manager    # clean up when done
+```
+
+### Scripts
+
+```bash
+npm install           # install dependencies
+npm run dev           # run via tsx (development)
+npm test              # run tests (vitest)
+npm run test:watch    # watch mode
+npm run build         # compile TypeScript to dist/
+```
+
+### Tech Stack
+
+- **Runtime**: Node.js + TypeScript (ESM)
+- **CLI framework**: [Commander.js](https://github.com/tj/commander.js)
+- **Git operations**: [simple-git](https://github.com/steveukx/git-js)
+- **Interactive prompts**: [@clack/prompts](https://github.com/bombshell-dev/clack)
+- **Testing**: [Vitest](https://vitest.dev/)
+- **Dev runner**: [tsx](https://github.com/privatenumber/tsx)
+
+### Project Structure
+
+```
+src/
+├── index.ts              # CLI entry point
+├── agents.ts             # 41-agent registry with path resolution
+├── auth.ts               # GitHub token resolution (gh CLI → env vars)
+├── lockfile.ts           # Read-only .skill-lock.json parser
+├── linker.ts             # Relative symlink creation
+├── git-ops.ts            # Git push/pull via simple-git
+└── commands/
+    ├── push.ts           # push command handler
+    ├── pull.ts           # pull command handler (auto-links)
+    └── link.ts           # link command handler (interactive)
+```
+
+### Adding a New Agent
+
+1. Add the agent ID to the `AgentId` union type in `src/agents.ts`
+2. Add the agent entry to `agentRegistry` with `displayName`, `projectPath`, `globalPath`, and `universal` flag
+3. If the agent uses an environment variable for path resolution, add it to `getAgentGlobalPath()`
+4. Add a test case in `src/agents.test.ts`
+
+## License
+
+MIT

package/dist/agents.d.ts

@@ -0,0 +1,19 @@
+export type AgentId = 'amp' | 'antigravity' | 'augment' | 'claude-code' | 'openclaw' | 'cline' | 'codebuddy' | 'codex' | 'command-code' | 'continue' | 'cortex' | 'crush' | 'cursor' | 'droid' | 'gemini-cli' | 'github-copilot' | 'goose' | 'junie' | 'iflow-cli' | 'kilo' | 'kimi-cli' | 'kiro-cli' | 'kode' | 'mcpjam' | 'mistral-vibe' | 'mux' | 'opencode' | 'openhands' | 'pi' | 'qoder' | 'qwen-code' | 'replit' | 'roo' | 'trae' | 'trae-cn' | 'windsurf' | 'zencoder' | 'neovate' | 'pochi' | 'adal' | 'universal';
+export interface AgentPaths {
+    displayName: string;
+    projectPath: string;
+    globalPath: string;
+    universal: boolean;
+}
+export declare const agentRegistry: Record<AgentId, AgentPaths>;
+/**
+ * Resolve an agent's global skills path to an absolute filesystem path.
+ * Handles ~, $XDG_CONFIG_HOME, $CODEX_HOME, $CLAUDE_CONFIG_DIR.
+ */
+export declare function getAgentGlobalPath(agentId: AgentId): string;
+/** Canonical skills directory — the source of truth. */
+export declare const CANONICAL_SKILLS_DIR: string;
+/** The git-managed agents directory — root of the backup repo. */
+export declare const AGENTS_DIR: string;
+/** Lock file path — READ ONLY, owned by vercel-labs/skills. */
+export declare const SKILL_LOCK_PATH: string;

package/dist/agents.js

@@ -0,0 +1,80 @@
+// src/agents.ts
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const agentRegistry = {
+    // UNIVERSAL GROUP (.agents/skills)
+    amp: { displayName: 'Amp', projectPath: '.agents/skills', globalPath: '~/.config/agents/skills', universal: true },
+    cline: { displayName: 'Cline', projectPath: '.agents/skills', globalPath: '~/.agents/skills', universal: true },
+    codex: { displayName: 'Codex', projectPath: '.agents/skills', globalPath: '$CODEX_HOME/skills', universal: true },
+    cursor: { displayName: 'Cursor', projectPath: '.agents/skills', globalPath: '~/.cursor/skills', universal: true },
+    'gemini-cli': { displayName: 'Gemini CLI', projectPath: '.agents/skills', globalPath: '~/.gemini/skills', universal: true },
+    'github-copilot': { displayName: 'GitHub Copilot', projectPath: '.agents/skills', globalPath: '~/.copilot/skills', universal: true },
+    'kimi-cli': { displayName: 'Kimi Code CLI', projectPath: '.agents/skills', globalPath: '~/.config/agents/skills', universal: true },
+    opencode: { displayName: 'OpenCode', projectPath: '.agents/skills', globalPath: '$XDG_CONFIG_HOME/opencode/skills', universal: true },
+    replit: { displayName: 'Replit', projectPath: '.agents/skills', globalPath: '~/.config/agents/skills', universal: true },
+    universal: { displayName: 'Universal', projectPath: '.agents/skills', globalPath: '~/.config/agents/skills', universal: true },
+    // NON-UNIVERSAL (agent-specific paths)
+    antigravity: { displayName: 'Antigravity', projectPath: '.agent/skills', globalPath: '~/.gemini/antigravity/skills', universal: false },
+    augment: { displayName: 'Augment', projectPath: '.augment/skills', globalPath: '~/.augment/skills', universal: false },
+    'claude-code': { displayName: 'Claude Code', projectPath: '.claude/skills', globalPath: '$CLAUDE_CONFIG_DIR/skills', universal: false },
+    openclaw: { displayName: 'OpenClaw', projectPath: 'skills', globalPath: '~/.openclaw/skills', universal: false },
+    codebuddy: { displayName: 'CodeBuddy', projectPath: '.codebuddy/skills', globalPath: '~/.codebuddy/skills', universal: false },
+    'command-code': { displayName: 'Command Code', projectPath: '.commandcode/skills', globalPath: '~/.commandcode/skills', universal: false },
+    continue: { displayName: 'Continue', projectPath: '.continue/skills', globalPath: '~/.continue/skills', universal: false },
+    cortex: { displayName: 'Cortex Code', projectPath: '.cortex/skills', globalPath: '~/.snowflake/cortex/skills', universal: false },
+    crush: { displayName: 'Crush', projectPath: '.crush/skills', globalPath: '~/.config/crush/skills', universal: false },
+    droid: { displayName: 'Droid', projectPath: '.factory/skills', globalPath: '~/.factory/skills', universal: false },
+    goose: { displayName: 'Goose', projectPath: '.goose/skills', globalPath: '~/.config/goose/skills', universal: false },
+    junie: { displayName: 'Junie', projectPath: '.junie/skills', globalPath: '~/.junie/skills', universal: false },
+    'iflow-cli': { displayName: 'iFlow CLI', projectPath: '.iflow/skills', globalPath: '~/.iflow/skills', universal: false },
+    kilo: { displayName: 'Kilo Code', projectPath: '.kilocode/skills', globalPath: '~/.kilocode/skills', universal: false },
+    'kiro-cli': { displayName: 'Kiro CLI', projectPath: '.kiro/skills', globalPath: '~/.kiro/skills', universal: false },
+    kode: { displayName: 'Kode', projectPath: '.kode/skills', globalPath: '~/.kode/skills', universal: false },
+    mcpjam: { displayName: 'MCPJam', projectPath: '.mcpjam/skills', globalPath: '~/.mcpjam/skills', universal: false },
+    'mistral-vibe': { displayName: 'Mistral Vibe', projectPath: '.vibe/skills', globalPath: '~/.vibe/skills', universal: false },
+    mux: { displayName: 'Mux', projectPath: '.mux/skills', globalPath: '~/.mux/skills', universal: false },
+    openhands: { displayName: 'OpenHands', projectPath: '.openhands/skills', globalPath: '~/.openhands/skills', universal: false },
+    pi: { displayName: 'Pi', projectPath: '.pi/skills', globalPath: '~/.pi/agent/skills', universal: false },
+    qoder: { displayName: 'Qoder', projectPath: '.qoder/skills', globalPath: '~/.qoder/skills', universal: false },
+    'qwen-code': { displayName: 'Qwen Code', projectPath: '.qwen/skills', globalPath: '~/.qwen/skills', universal: false },
+    roo: { displayName: 'Roo Code', projectPath: '.roo/skills', globalPath: '~/.roo/skills', universal: false },
+    trae: { displayName: 'Trae', projectPath: '.trae/skills', globalPath: '~/.trae/skills', universal: false },
+    'trae-cn': { displayName: 'Trae CN', projectPath: '.trae/skills', globalPath: '~/.trae-cn/skills', universal: false },
+    windsurf: { displayName: 'Windsurf', projectPath: '.windsurf/skills', globalPath: '~/.codeium/windsurf/skills', universal: false },
+    zencoder: { displayName: 'Zencoder', projectPath: '.zencoder/skills', globalPath: '~/.zencoder/skills', universal: false },
+    neovate: { displayName: 'Neovate', projectPath: '.neovate/skills', globalPath: '~/.neovate/skills', universal: false },
+    pochi: { displayName: 'Pochi', projectPath: '.pochi/skills', globalPath: '~/.pochi/skills', universal: false },
+    adal: { displayName: 'AdaL', projectPath: '.adal/skills', globalPath: '~/.adal/skills', universal: false },
+};
+/**
+ * Resolve an agent's global skills path to an absolute filesystem path.
+ * Handles ~, $XDG_CONFIG_HOME, $CODEX_HOME, $CLAUDE_CONFIG_DIR.
+ */
+export function getAgentGlobalPath(agentId) {
+    const home = homedir();
+    let p = agentRegistry[agentId].globalPath;
+    // Resolve env-var-based paths first
+    if (p.startsWith('$XDG_CONFIG_HOME')) {
+        const xdg = process.env.XDG_CONFIG_HOME ?? join(home, '.config');
+        p = p.replace('$XDG_CONFIG_HOME', xdg);
+    }
+    else if (p.startsWith('$CODEX_HOME')) {
+        const codex = process.env.CODEX_HOME ?? join(home, '.codex');
+        p = p.replace('$CODEX_HOME', codex);
+    }
+    else if (p.startsWith('$CLAUDE_CONFIG_DIR')) {
+        const claude = process.env.CLAUDE_CONFIG_DIR ?? join(home, '.claude');
+        p = p.replace('$CLAUDE_CONFIG_DIR', claude);
+    }
+    else if (p.startsWith('~')) {
+        p = p.replace('~', home);
+    }
+    return p;
+}
+/** Canonical skills directory — the source of truth. */
+export const CANONICAL_SKILLS_DIR = join(homedir(), '.agents', 'skills');
+/** The git-managed agents directory — root of the backup repo. */
+export const AGENTS_DIR = join(homedir(), '.agents');
+/** Lock file path — READ ONLY, owned by vercel-labs/skills. */
+export const SKILL_LOCK_PATH = join(homedir(), '.agents', '.skill-lock.json');
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,mCAAmC;IACnC,GAAG,EAAe,EAAE,WAAW,EAAE,KAAK,EAAe,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,yBAAyB,EAAI,SAAS,EAAE,IAAI,EAAE;IAC9I,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAW,SAAS,EAAE,IAAI,EAAE;IAC9I,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAS,SAAS,EAAE,IAAI,EAAE;IAC9I,MAAM,EAAY,EAAE,WAAW,EAAE,QAAQ,EAAY,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAW,SAAS,EAAE,IAAI,EAAE;IAC9I,YAAY,EAAM,EAAE,WAAW,EAAE,YAAY,EAAQ,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAW,SAAS,EAAE,IAAI,EAAE;IAC9I,gBAAgB,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAI,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAU,SAAS,EAAE,IAAI,EAAE;IAC9I,UAAU,EAAQ,EAAE,WAAW,EAAE,eAAe,EAAK,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,yBAAyB,EAAI,SAAS,EAAE,IAAI,EAAE;IAC9I,QAAQ,EAAU,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,kCAAkC,EAAE,SAAS,EAAE,IAAI,EAAE;IACrJ,MAAM,EAAY,EAAE,WAAW,EAAE,QAAQ,EAAa,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,yBAAyB,EAAI,SAAS,EAAE,IAAI,EAAE;IAC/I,SAAS,EAAS,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,yBAAyB,EAAI,SAAS,EAAE,IAAI,EAAE;IAE9I,uCAAuC;IACvC,WAAW,EAAO,EAAE,WAAW,EAAE,aAAa,EAAO,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,8BAA8B,EAAK,SAAS,EAAE,KAAK,EAAE;IAC3J,OAAO,EAAW,EAAE,WAAW,EAAE,SAAS,EAAW,WAAW,EAAE,iBAAiB,EAAO,UAAU,EAAE,mBAAmB,EAAgB,SAAS,EAAE,KAAK,EAAE;IAC3J,aAAa,EAAK,EAAE,WAAW,EAAE,aAAa,EAAO,WAAW,EAAE,gBAAgB,EAAQ,UAAU,EAAE,2BAA2B,EAAQ,SAAS,EAAE,KAAK,EAAE;IAC3J,QAAQ,EAAU,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,QAAQ,EAAgB,UAAU,EAAE,oBAAoB,EAAe,SAAS,EAAE,KAAK,EAAE;IAC3J,SAAS,EAAS,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,mBAAmB,EAAK,UAAU,EAAE,qBAAqB,EAAc,SAAS,EAAE,KAAK,EAAE;IAC3J,cAAc,EAAI,EAAE,WAAW,EAAE,cAAc,EAAM,WAAW,EAAE,qBAAqB,EAAG,UAAU,EAAE,uBAAuB,EAAY,SAAS,EAAE,KAAK,EAAE;IAC3J,QAAQ,EAAU,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,kBAAkB,EAAM,UAAU,EAAE,oBAAoB,EAAe,SAAS,EAAE,KAAK,EAAE;IAC3J,MAAM,EAAY,EAAE,WAAW,EAAE,aAAa,EAAO,WAAW,EAAE,gBAAgB,EAAQ,UAAU,EAAE,4BAA4B,EAAO,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,wBAAwB,EAAW,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,iBAAiB,EAAO,UAAU,EAAE,mBAAmB,EAAgB,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,wBAAwB,EAAW,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,iBAAiB,EAAkB,SAAS,EAAE,KAAK,EAAE;IAC3J,WAAW,EAAO,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,iBAAiB,EAAkB,SAAS,EAAE,KAAK,EAAE;IAC3J,IAAI,EAAc,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,kBAAkB,EAAM,UAAU,EAAE,oBAAoB,EAAe,SAAS,EAAE,KAAK,EAAE;IAC3J,UAAU,EAAQ,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;IAC3J,IAAI,EAAc,EAAE,WAAW,EAAE,MAAM,EAAc,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;IAC3J,MAAM,EAAY,EAAE,WAAW,EAAE,QAAQ,EAAY,WAAW,EAAE,gBAAgB,EAAQ,UAAU,EAAE,kBAAkB,EAAiB,SAAS,EAAE,KAAK,EAAE;IAC3J,cAAc,EAAI,EAAE,WAAW,EAAE,cAAc,EAAM,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;IAC3J,GAAG,EAAe,EAAE,WAAW,EAAE,KAAK,EAAe,WAAW,EAAE,aAAa,EAAW,UAAU,EAAE,eAAe,EAAoB,SAAS,EAAE,KAAK,EAAE;IAC3J,SAAS,EAAS,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,mBAAmB,EAAK,UAAU,EAAE,qBAAqB,EAAc,SAAS,EAAE,KAAK,EAAE;IAC3J,EAAE,EAAgB,EAAE,WAAW,EAAE,IAAI,EAAgB,WAAW,EAAE,YAAY,EAAY,UAAU,EAAE,oBAAoB,EAAe,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,iBAAiB,EAAkB,SAAS,EAAE,KAAK,EAAE;IAC3J,WAAW,EAAO,EAAE,WAAW,EAAE,WAAW,EAAS,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;IAC3J,GAAG,EAAe,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,aAAa,EAAW,UAAU,EAAE,eAAe,EAAoB,SAAS,EAAE,KAAK,EAAE;IAC3J,IAAI,EAAc,EAAE,WAAW,EAAE,MAAM,EAAc,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;IAC3J,SAAS,EAAS,EAAE,WAAW,EAAE,SAAS,EAAW,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,mBAAmB,EAAgB,SAAS,EAAE,KAAK,EAAE;IAC3J,QAAQ,EAAU,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,kBAAkB,EAAM,UAAU,EAAE,4BAA4B,EAAO,SAAS,EAAE,KAAK,EAAE;IAC3J,QAAQ,EAAU,EAAE,WAAW,EAAE,UAAU,EAAU,WAAW,EAAE,kBAAkB,EAAM,UAAU,EAAE,oBAAoB,EAAe,SAAS,EAAE,KAAK,EAAE;IAC3J,OAAO,EAAW,EAAE,WAAW,EAAE,SAAS,EAAW,WAAW,EAAE,iBAAiB,EAAO,UAAU,EAAE,mBAAmB,EAAgB,SAAS,EAAE,KAAK,EAAE;IAC3J,KAAK,EAAa,EAAE,WAAW,EAAE,OAAO,EAAa,WAAW,EAAE,eAAe,EAAS,UAAU,EAAE,iBAAiB,EAAkB,SAAS,EAAE,KAAK,EAAE;IAC3J,IAAI,EAAc,EAAE,WAAW,EAAE,MAAM,EAAc,WAAW,EAAE,cAAc,EAAU,UAAU,EAAE,gBAAgB,EAAmB,SAAS,EAAE,KAAK,EAAE;CAC5J,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;IAE1C,oCAAoC;IACpC,IAAI,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEzE,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAErD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get GitHub token. Priority: gh auth token > GITHUB_TOKEN > GH_TOKEN.
+ * Returns null if none available.
+ */
+export declare function getGitHubToken(): string | null;
+/**
+ * Ensure a GitHub token is available. If not, interactively guide the user
+ * through authentication. Returns token or throws CliError.
+ */
+export declare function ensureGitHubToken(): Promise<string>;

package/dist/auth.js

@@ -0,0 +1,70 @@
+// src/auth.ts
+import { execSync, spawnSync } from 'node:child_process';
+import * as p from '@clack/prompts';
+import { CliError } from './errors.js';
+/**
+ * Get GitHub token. Priority: gh auth token > GITHUB_TOKEN > GH_TOKEN.
+ * Returns null if none available.
+ */
+export function getGitHubToken() {
+    // Try gh CLI first
+    try {
+        const token = execSync('gh auth token', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (token)
+            return token;
+    }
+    catch {
+        // gh not installed or not authenticated
+    }
+    // Fallback to env vars
+    if (process.env.GITHUB_TOKEN)
+        return process.env.GITHUB_TOKEN;
+    if (process.env.GH_TOKEN)
+        return process.env.GH_TOKEN;
+    return null;
+}
+/**
+ * Ensure a GitHub token is available. If not, interactively guide the user
+ * through authentication. Returns token or throws CliError.
+ */
+export async function ensureGitHubToken() {
+    const existing = getGitHubToken();
+    if (existing)
+        return existing;
+    const method = await p.select({
+        message: 'No GitHub authentication found. How would you like to authenticate?',
+        options: [
+            { value: 'gh', label: 'Run gh auth login', hint: 'recommended — opens GitHub CLI login flow' },
+            { value: 'env', label: 'Set GITHUB_TOKEN manually', hint: 'export GITHUB_TOKEN=ghp_...' },
+        ],
+    });
+    if (p.isCancel(method)) {
+        p.cancel('Authentication cancelled.');
+        throw new CliError('Authentication cancelled.');
+    }
+    if (method === 'gh') {
+        p.log.step('Starting gh auth login...');
+        const result = spawnSync('gh', ['auth', 'login'], {
+            stdio: 'inherit',
+        });
+        if (result.status !== 0) {
+            p.cancel('gh auth login failed. Please try again.');
+            throw new CliError('gh auth login failed.');
+        }
+        const token = getGitHubToken();
+        if (!token) {
+            p.cancel('Still no token after gh auth login. Please try again.');
+            throw new CliError('No token after gh auth login.');
+        }
+        return token;
+    }
+    // method === 'env'
+    p.note('Run one of the following, then re-run your command:\n\n' +
+        '  export GITHUB_TOKEN=ghp_your_token_here\n' +
+        '  export GH_TOKEN=ghp_your_token_here', 'Set environment variable');
+    throw new CliError('Please set GITHUB_TOKEN and try again.');
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAEtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,qEAAqE;QAC9E,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,2CAA2C,EAAE;YAC9F,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,6BAA6B,EAAE;SAC1F;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACtC,MAAM,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAChD,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,CAAC,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;YACpD,MAAM,IAAI,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,CAAC,CAAC,MAAM,CAAC,uDAAuD,CAAC,CAAC;YAClE,MAAM,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mBAAmB;IACnB,CAAC,CAAC,IAAI,CACJ,yDAAyD;QACzD,6CAA6C;QAC7C,uCAAuC,EACvC,0BAA0B,CAC3B,CAAC;IACF,MAAM,IAAI,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/commands/link.d.ts

@@ -0,0 +1,3 @@
+export declare function linkCommand(options: {
+    agents?: string[];
+}): Promise<void>;

package/dist/commands/link.js

@@ -0,0 +1,109 @@
+import { existsSync } from 'node:fs';
+import { CANONICAL_SKILLS_DIR, SKILL_LOCK_PATH, agentRegistry, getAgentGlobalPath } from '../agents.js';
+import { CliError } from '../errors.js';
+import { readConfig, writeConfig } from '../config.js';
+import { getLastSelectedAgents } from '../lockfile.js';
+import { createSkillSymlinks, listCanonicalSkills } from '../linker.js';
+import * as p from '@clack/prompts';
+export async function linkCommand(options) {
+    p.intro('skills-manager link');
+    // 1. Read lock file for lastSelectedAgents
+    let agents;
+    if (options.agents?.length) {
+        const validIds = new Set(Object.keys(agentRegistry));
+        const invalid = options.agents.filter(id => !validIds.has(id));
+        if (invalid.length > 0) {
+            p.cancel(`Unknown agent ID(s): ${invalid.join(', ')}. Run with no --agents to see available IDs.`);
+            throw new CliError(`Unknown agent ID(s): ${invalid.join(', ')}`);
+        }
+        agents = options.agents;
+    }
+    else {
+        agents = await getLastSelectedAgents(SKILL_LOCK_PATH);
+        if (agents.length === 0) {
+            p.cancel('No lastSelectedAgents found in .skill-lock.json. Use --agents to specify.');
+            throw new CliError('No lastSelectedAgents found in .skill-lock.json.');
+        }
+    }
+    // 2. Interactive confirmation
+    const agentChoices = agents.map(id => {
+        const globalPath = getAgentGlobalPath(id);
+        const dirExists = existsSync(globalPath);
+        return {
+            value: id,
+            label: `${agentRegistry[id].displayName} (${id})`,
+            hint: dirExists ? globalPath : `${globalPath} — directory will be created`,
+        };
+    });
+    const selected = await p.multiselect({
+        message: 'Select agents to link skills to:',
+        options: agentChoices,
+        initialValues: computeInitialValues(agents, agentChoices),
+        required: false,
+    });
+    if (p.isCancel(selected) || !selected.length) {
+        p.cancel('No agents selected.');
+        return;
+    }
+    // 3. Get skill list
+    const skills = await listCanonicalSkills(CANONICAL_SKILLS_DIR);
+    if (skills.length === 0) {
+        p.cancel(`No skills found in ${CANONICAL_SKILLS_DIR}.`);
+        throw new CliError(`No skills found in ${CANONICAL_SKILLS_DIR}.`);
+    }
+    // 4. Create symlinks for each agent
+    const linkedAgents = [];
+    const skippedAgents = [];
+    const validSelected = new Set(Object.keys(agentRegistry));
+    const selectedAgents = selected.filter((id) => validSelected.has(id));
+    for (const agentId of selectedAgents) {
+        const globalPath = getAgentGlobalPath(agentId);
+        const spinner = p.spinner();
+        spinner.start(`Linking ${agentRegistry[agentId].displayName}...`);
+        try {
+            const results = await createSkillSymlinks(CANONICAL_SKILLS_DIR, globalPath, skills);
+            const created = results.filter(r => r.status === 'created').length;
+            const recreated = results.filter(r => r.status === 'recreated').length;
+            const existed = results.filter(r => r.status === 'exists').length;
+            const skipped = results.filter(r => r.status === 'skipped').length;
+            const parts = [`${created} linked`];
+            if (recreated > 0)
+                parts.push(`${recreated} recreated`);
+            parts.push(`${existed} existing`, `${skipped} skipped`);
+            spinner.stop(`${agentRegistry[agentId].displayName}: ${parts.join(', ')}`);
+            linkedAgents.push(agentId);
+        }
+        catch (err) {
+            spinner.stop(`${agentRegistry[agentId].displayName}: failed`);
+            skippedAgents.push({ id: agentId, reason: String(err) });
+        }
+    }
+    // 5. Save selection for next time
+    if (linkedAgents.length > 0) {
+        writeConfig({ lastLinkedAgents: selectedAgents });
+    }
+    // 6. Summary
+    p.note([
+        linkedAgents.length > 0 ? `✓ Linked: ${linkedAgents.join(', ')}` : '',
+        skippedAgents.length > 0 ? `✗ Skipped: ${skippedAgents.map(s => `${s.id} (${s.reason})`).join(', ')}` : '',
+    ].filter(Boolean).join('\n'), 'Summary');
+    p.outro('Done!');
+}
+/**
+ * Determine which agents should be pre-selected in the multiselect.
+ * Priority: saved lastLinkedAgents (if any match current list) > existsSync fallback.
+ */
+function computeInitialValues(agents, choices) {
+    const config = readConfig();
+    const saved = config.lastLinkedAgents;
+    if (saved && saved.length > 0) {
+        const agentSet = new Set(agents);
+        const matching = saved.filter(id => agentSet.has(id));
+        if (matching.length > 0) {
+            return matching;
+        }
+    }
+    // Fallback: pre-select agents whose directories exist locally
+    return choices.filter(c => existsSync(getAgentGlobalPath(c.value))).map(c => c.value);
+}
+//# sourceMappingURL=link.js.map

package/dist/commands/link.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,4 @@
+export declare function pullCommand(options: {
+    repo?: string;
+    skipLink?: boolean;
+}): Promise<void>;

package/dist/commands/pull.js

@@ -0,0 +1,57 @@
+import { AGENTS_DIR } from '../agents.js';
+import { ensureGitHubToken } from '../auth.js';
+import { CliError } from '../errors.js';
+import { pullSkills, buildRemoteUrl, getRepoRemoteUrl, ensureGitRepo, ensureRemote, } from '../git-ops.js';
+import { linkCommand } from './link.js';
+import * as p from '@clack/prompts';
+export async function pullCommand(options) {
+    p.intro('skills-manager pull');
+    const token = await ensureGitHubToken();
+    // Determine remote URL
+    let remoteUrl;
+    if (options.repo) {
+        remoteUrl = buildRemoteUrl(options.repo);
+    }
+    else {
+        const existing = await getRepoRemoteUrl(AGENTS_DIR);
+        if (existing) {
+            remoteUrl = existing;
+        }
+        else {
+            // No --repo flag and no existing remote — prompt interactively
+            await ensureGitRepo(AGENTS_DIR);
+            const repo = await p.text({
+                message: 'Enter GitHub repo to pull from (owner/name):',
+                placeholder: 'e.g. tc9011/my-skills',
+            });
+            if (p.isCancel(repo)) {
+                p.cancel('Pull cancelled.');
+                throw new CliError('Pull cancelled by user.');
+            }
+            const result = await ensureRemote(AGENTS_DIR, repo);
+            remoteUrl = result.remoteUrl;
+        }
+    }
+    // Pull
+    const spinner = p.spinner();
+    spinner.start('Pulling skills from GitHub...');
+    try {
+        const result = await pullSkills(AGENTS_DIR, remoteUrl, token);
+        spinner.stop(result.cloned
+            ? 'Skills cloned successfully!'
+            : 'Skills updated from remote.');
+    }
+    catch (err) {
+        spinner.stop('Pull failed.');
+        p.cancel(String(err));
+        throw new CliError(String(err));
+    }
+    // Auto-run link unless skipped
+    if (!options.skipLink) {
+        await linkCommand({});
+    }
+    else {
+        p.outro('Pull complete. Run `skills-manager link` to create agent symlinks.');
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA8C;IAC9E,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAExC,uBAAuB;IACvB,IAAI,SAAiB,CAAC;IACtB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS,GAAG,QAAQ,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;YAEhC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACxB,OAAO,EAAE,8CAA8C;gBACvD,WAAW,EAAE,uBAAuB;aACrC,CAAC,CAAC;YAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBAC5B,MAAM,IAAI,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpD,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO;IACP,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CACV,MAAM,CAAC,MAAM;YACX,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/commands/push.d.ts

@@ -0,0 +1,3 @@
+export declare function pushCommand(options: {
+    message?: string;
+}): Promise<void>;