skilluse 0.1.0

package/README.md

@@ -0,0 +1,100 @@
+# Skilluse CLI
+
+CLI tool for managing and installing AI Coding Agent Skills.
+
+## Installation
+
+```bash
+npm install -g skilluse
+```
+
+## Quick Start
+
+```bash
+# Login to GitHub
+skilluse login
+
+# Add a skill repository
+skilluse repo add owner/skill-repo
+
+# Search for skills
+skilluse search code-review
+
+# Install a skill
+skilluse install code-review
+
+# List installed skills
+skilluse list
+```
+
+## Commands
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `skilluse` | Show status (user, repos, installed count) |
+| `skilluse login` | Authenticate with GitHub |
+| `skilluse logout` | Clear stored credentials |
+
+### Repository Management
+
+| Command | Description |
+|---------|-------------|
+| `skilluse repo list` | List configured repositories |
+| `skilluse repo add <repo>` | Add a skill repository |
+| `skilluse repo remove <name>` | Remove a repository |
+| `skilluse repo use <name>` | Set default repository |
+| `skilluse repo edit <name>` | Edit repository settings |
+
+### Skill Management
+
+| Command | Description |
+|---------|-------------|
+| `skilluse search <keyword>` | Search for skills |
+| `skilluse install <skill>` | Install skill locally |
+| `skilluse install <skill> --global` | Install globally |
+| `skilluse uninstall <skill>` | Remove installed skill |
+| `skilluse upgrade [skill]` | Upgrade skill(s) to latest |
+| `skilluse list` | List installed skills |
+| `skilluse list --outdated` | Show skills with updates |
+| `skilluse info <skill>` | Show skill details |
+
+## Authentication
+
+Skilluse uses GitHub App OAuth for authentication.
+
+### First-Time Login
+
+1. Run `skilluse login`
+2. Enter the code shown in your browser
+3. Install the GitHub App when prompted
+4. Select repository access (all or specific repos)
+
+### Managing Repository Access
+
+Modify access at: https://github.com/settings/installations
+
+### Logging Out
+
+```bash
+skilluse logout
+```
+
+## Install Locations
+
+| Scope | Path |
+|-------|------|
+| Local | `./.claude/skills/<name>/` |
+| Global | `~/.claude/skills/<name>/` |
+
+## Security
+
+- **User tokens** stored in system keychain (macOS/Windows/Linux)
+- **Fallback** to encrypted file if keychain unavailable
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `SKILLUSE_GITHUB_CLIENT_ID` | Override GitHub App client ID (dev only) |

package/dist/app.d.ts

@@ -0,0 +1,6 @@
+interface AppProps {
+    name?: string;
+}
+export default function App({ name }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=app.d.ts.map

package/dist/app.js

@@ -0,0 +1,6 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+export default function App({ name = "skilluse" }) {
+    return (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { color: "green", children: [name, " - AI Coding Agent Skills Manager"] }) }));
+}
+//# sourceMappingURL=app.js.map

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env bun
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Static CLI entry point for compiled binaries.
+ * This file imports all commands statically to work with Bun's single-file compilation.
+ *
+ * For development, use src/index.tsx which uses Pastel's dynamic command discovery.
+ */
+import { Command } from "commander";
+import { render } from "ink";
+// Import all commands statically
+import Demo, { options as demoOptions } from "./commands/demo.js";
+import Login, { options as loginOptions } from "./commands/login.js";
+import Logout from "./commands/logout.js";
+import Whoami from "./commands/whoami.js";
+import Repos from "./commands/repos.js";
+import Skills from "./commands/skills.js";
+import List, { options as listOptions } from "./commands/list.js";
+import Search, { args as searchArgs, options as searchOptions } from "./commands/search.js";
+// Import repo subcommands
+import RepoIndex from "./commands/repo/index.js";
+import RepoList from "./commands/repo/list.js";
+import RepoAdd, { args as repoAddArgs, options as repoAddOptions } from "./commands/repo/add.js";
+import RepoRemove, { args as repoRemoveArgs, options as repoRemoveOptions } from "./commands/repo/remove.js";
+import RepoEdit, { args as repoEditArgs, options as repoEditOptions } from "./commands/repo/edit.js";
+import RepoSync, { args as repoSyncArgs, options as repoSyncOptions } from "./commands/repo/sync.js";
+import RepoUse, { args as repoUseArgs } from "./commands/repo/use.js";
+// Version injected via --define at build time, fallback to package.json
+const VERSION = process.env.VERSION || "0.1.0";
+const BUILD_TIME = process.env.BUILD_TIME || new Date().toISOString();
+const program = new Command();
+program
+    .name("skilluse")
+    .description("CLI tool for managing and installing AI Coding Agent Skills")
+    .version(VERSION, "-v, --version", "Show version number")
+    .option("--version-verbose", "Show version with build info")
+    .on("option:version-verbose", () => {
+    console.log(`skilluse ${VERSION}`);
+    console.log(`Built: ${BUILD_TIME}`);
+    process.exit(0);
+});
+// demo command
+program
+    .command("demo")
+    .description("Demo UI components")
+    .option("-a, --all", "Show all components")
+    .action((opts) => {
+    const options = demoOptions.parse(opts);
+    render(_jsx(Demo, { options: options }));
+});
+// login command
+program
+    .command("login")
+    .description("Authenticate with GitHub")
+    .option("-f, --force", "Force re-authentication")
+    .action((opts) => {
+    const options = loginOptions.parse(opts);
+    render(_jsx(Login, { options: options }));
+});
+// logout command
+program
+    .command("logout")
+    .description("Clear stored credentials")
+    .action(() => {
+    render(_jsx(Logout, { options: {} }));
+});
+// whoami command
+program
+    .command("whoami")
+    .description("Show current user info")
+    .action(() => {
+    render(_jsx(Whoami, { options: {} }));
+});
+// repos command
+program
+    .command("repos")
+    .description("List accessible GitHub repositories")
+    .action(() => {
+    render(_jsx(Repos, { options: {} }));
+});
+// skills command
+program
+    .command("skills")
+    .description("List installed skills")
+    .action(() => {
+    render(_jsx(Skills, { options: {} }));
+});
+// list command
+program
+    .command("list")
+    .description("List skills from a repository")
+    .option("-r, --repo <repo>", "Repository to list skills from")
+    .action((opts) => {
+    const options = listOptions.parse(opts);
+    render(_jsx(List, { options: options }));
+});
+// search command
+program
+    .command("search <keyword>")
+    .description("Search for skills")
+    .option("-a, --all", "Search in all configured repos")
+    .action((keyword, opts) => {
+    const args = searchArgs.parse([keyword]);
+    const options = searchOptions.parse(opts);
+    render(_jsx(Search, { args: args, options: options }));
+});
+// repo command group
+const repoCmd = program
+    .command("repo")
+    .description("Manage skill repositories");
+repoCmd
+    .command("list")
+    .description("List configured repositories")
+    .action(() => {
+    render(_jsx(RepoList, { options: {} }));
+});
+repoCmd
+    .command("add <url>")
+    .description("Add a skill repository")
+    .option("-p, --path <path>", "Skill path within the repo")
+    .option("-b, --branch <branch>", "Branch to use")
+    .option("-d, --default", "Set as default repository")
+    .action((url, opts) => {
+    const args = repoAddArgs.parse([url]);
+    const options = repoAddOptions.parse(opts);
+    render(_jsx(RepoAdd, { args: args, options: options }));
+});
+repoCmd
+    .command("remove <name>")
+    .description("Remove a repository")
+    .option("-f, --force", "Skip confirmation")
+    .action((name, opts) => {
+    const args = repoRemoveArgs.parse([name]);
+    const options = repoRemoveOptions.parse(opts);
+    render(_jsx(RepoRemove, { args: args, options: options }));
+});
+repoCmd
+    .command("edit <name>")
+    .description("Edit repository settings")
+    .option("-p, --path <path>", "New skill path")
+    .option("-b, --branch <branch>", "New branch")
+    .action((name, opts) => {
+    const args = repoEditArgs.parse([name]);
+    const options = repoEditOptions.parse(opts);
+    render(_jsx(RepoEdit, { args: args, options: options }));
+});
+repoCmd
+    .command("sync [name]")
+    .description("Sync repository metadata")
+    .action((name, _opts) => {
+    const args = repoSyncArgs.parse([name || undefined]);
+    const options = repoSyncOptions.parse({});
+    render(_jsx(RepoSync, { args: args, options: options }));
+});
+repoCmd
+    .command("use <name>")
+    .description("Set default repository")
+    .action((name, _opts) => {
+    const args = repoUseArgs.parse([name]);
+    render(_jsx(RepoUse, { args: args, options: {} }));
+});
+// Default action shows help when just 'repo' is called
+repoCmd.action(() => {
+    render(_jsx(RepoIndex, { options: {} }));
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/commands/demo.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const options: z.ZodObject<{
+    component: z.ZodDefault<z.ZodEnum<["spinner", "select", "table", "progress", "status", "input", "all"]>>;
+}, "strip", z.ZodTypeAny, {
+    component: "spinner" | "select" | "table" | "progress" | "status" | "input" | "all";
+}, {
+    component?: "spinner" | "select" | "table" | "progress" | "status" | "input" | "all" | undefined;
+}>;
+interface Props {
+    options: z.infer<typeof options>;
+}
+export default function Demo({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/commands/demo.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Box, Text } from "ink";
+import { z } from "zod";
+import { Spinner, Select, Table, ProgressBar, StatusMessage, TextInput, } from "../components/index.js";
+export const options = z.object({
+    component: z
+        .enum(["spinner", "select", "table", "progress", "status", "input", "all"])
+        .default("all")
+        .describe("Component to demo"),
+});
+function SpinnerDemo() {
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "Spinner Component:" }), _jsx(Spinner, { text: "Loading..." })] }));
+}
+function SelectDemo() {
+    const [selected, setSelected] = useState(null);
+    const items = [
+        { label: "Option 1", value: "1" },
+        { label: "Option 2", value: "2" },
+        { label: "Option 3", value: "3" },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "Select Component:" }), selected ? (_jsxs(Text, { children: ["Selected: ", selected] })) : (_jsx(Select, { items: items, onSelect: (item) => setSelected(item.value) }))] }));
+}
+function TableDemo() {
+    const data = [
+        { name: "skill-1", version: "1.0.0", status: "installed" },
+        { name: "skill-2", version: "2.1.0", status: "available" },
+        { name: "skill-3", version: "0.5.0", status: "installed" },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "Table Component:" }), _jsx(Table, { data: data, columns: ["name", "version", "status"] })] }));
+}
+function ProgressDemo() {
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "ProgressBar Component:" }), _jsx(ProgressBar, { percent: 0, width: 20 }), _jsx(ProgressBar, { percent: 50, width: 20 }), _jsx(ProgressBar, { percent: 100, width: 20 })] }));
+}
+function StatusDemo() {
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "StatusMessage Component:" }), _jsx(StatusMessage, { type: "success", children: "Operation completed" }), _jsx(StatusMessage, { type: "error", children: "Something went wrong" }), _jsx(StatusMessage, { type: "warning", children: "Proceed with caution" })] }));
+}
+function TextInputDemo() {
+    const [value, setValue] = useState("");
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, children: "TextInput Component:" }), _jsxs(Box, { children: [_jsx(Text, { children: "Enter text: " }), _jsx(TextInput, { value: value, onChange: setValue, placeholder: "Type something..." })] }), value && _jsxs(Text, { dimColor: true, children: ["You typed: ", value] })] }));
+}
+export default function Demo({ options: opts }) {
+    const { component } = opts;
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { color: "green", bold: true, children: "UI Components Demo" }), (component === "all" || component === "spinner") && _jsx(SpinnerDemo, {}), (component === "all" || component === "select") && _jsx(SelectDemo, {}), (component === "all" || component === "table") && _jsx(TableDemo, {}), (component === "all" || component === "progress") && _jsx(ProgressDemo, {}), (component === "all" || component === "status") && _jsx(StatusDemo, {}), (component === "all" || component === "input") && _jsx(TextInputDemo, {})] }));
+}
+//# sourceMappingURL=demo.js.map

package/dist/commands/index.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const options: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+interface Props {
+    options: z.infer<typeof options>;
+}
+export default function Index(_props: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { Box, Text, useApp } from "ink";
+import { z } from "zod";
+import { Spinner, StatusMessage } from "../components/index.js";
+import { getCredentials, getConfig, getInstallations, checkForUpdate, getCurrentVersion, } from "../services/index.js";
+export const options = z.object({});
+export default function Index(_props) {
+    const { exit } = useApp();
+    const [state, setState] = useState({ phase: "checking" });
+    useEffect(() => {
+        async function checkStatus() {
+            // Check if logged in
+            const credentials = await getCredentials();
+            if (!credentials) {
+                setState({ phase: "not_logged_in" });
+                exit();
+                return;
+            }
+            // Fetch user info from GitHub
+            try {
+                const response = await fetch("https://api.github.com/user", {
+                    headers: {
+                        Authorization: `Bearer ${credentials.token}`,
+                        Accept: "application/vnd.github+json",
+                    },
+                });
+                if (!response.ok) {
+                    if (response.status === 401) {
+                        setState({ phase: "not_logged_in" });
+                    }
+                    else {
+                        setState({
+                            phase: "error",
+                            message: `GitHub API error: ${response.status}`,
+                        });
+                    }
+                    exit();
+                    return;
+                }
+                const userData = (await response.json());
+                const config = getConfig();
+                const installations = getInstallations();
+                // Check for updates (non-blocking, uses cache)
+                const updateInfo = await checkForUpdate();
+                setState({
+                    phase: "logged_in",
+                    user: userData,
+                    defaultRepo: config.defaultRepo,
+                    installedCount: config.installed.length,
+                    repoCount: config.repos.length,
+                    installations,
+                    updateInfo,
+                });
+            }
+            catch (err) {
+                setState({
+                    phase: "error",
+                    message: err instanceof Error ? err.message : "Failed to fetch status",
+                });
+            }
+            exit();
+        }
+        checkStatus();
+    }, [exit]);
+    switch (state.phase) {
+        case "checking":
+            return _jsx(Spinner, { text: "Loading..." });
+        case "not_logged_in":
+            return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", bold: true, children: "Welcome to skilluse!" }) }), _jsx(Text, { dimColor: true, children: "Let's get you set up:" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: "  1. " }), _jsx(Text, { children: "skilluse login      " }), _jsx(Text, { dimColor: true, children: "Connect to GitHub" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: "  2. " }), _jsx(Text, { children: "skilluse repo add   " }), _jsx(Text, { dimColor: true, children: "Add a skill repository" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: "  3. " }), _jsx(Text, { children: "skilluse search     " }), _jsx(Text, { dimColor: true, children: "Find skills to install" })] })] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { children: "Run " }), _jsx(Text, { color: "green", children: "skilluse login" }), _jsx(Text, { children: " to get started." })] })] }));
+        case "logged_in":
+            return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "green", bold: true, children: "skilluse" }), _jsxs(Text, { dimColor: true, children: [" v", getCurrentVersion()] }), state.updateInfo?.hasUpdate && (_jsxs(Text, { color: "yellow", children: [" ", "(update available: v", state.updateInfo.latestVersion, " - run 'npm update -g skilluse')"] }))] }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsxs(Box, { children: [_jsx(Text, { children: "Logged in as " }), _jsx(Text, { color: "green", bold: true, children: state.user.login }), state.user.name && _jsxs(Text, { dimColor: true, children: [" (", state.user.name, ")"] })] }) }), _jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { children: "Default repo: " }), state.defaultRepo ? (_jsx(Text, { color: "cyan", children: state.defaultRepo })) : (_jsx(Text, { dimColor: true, children: "(not set)" }))] }), _jsxs(Box, { children: [_jsx(Text, { children: "Configured repos: " }), _jsx(Text, { children: state.repoCount })] }), _jsxs(Box, { children: [_jsx(Text, { children: "Installed skills: " }), _jsx(Text, { children: state.installedCount })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Quick Actions:" }), _jsx(Text, { dimColor: true, children: "  skilluse repo add owner/repo   Add a skill repository" }), _jsx(Text, { dimColor: true, children: "  skilluse list                  Browse available skills" }), _jsx(Text, { dimColor: true, children: "  skilluse install skill-name    Install a skill" }), _jsx(Text, { dimColor: true, children: "  skilluse --help                Show all commands" })] })] }));
+        case "error":
+            return _jsx(StatusMessage, { type: "error", children: state.message });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/list.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const options: z.ZodObject<{
+    outdated: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    outdated: boolean;
+}, {
+    outdated?: boolean | undefined;
+}>;
+interface Props {
+    options: z.infer<typeof options>;
+}
+export default function List({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { Box, Text, useApp } from "ink";
+import { z } from "zod";
+import { Spinner, StatusMessage } from "../components/index.js";
+import { getCredentials, getConfig, } from "../services/index.js";
+export const options = z.object({
+    outdated: z
+        .boolean()
+        .default(false)
+        .describe("Show only outdated skills"),
+});
+export default function List({ options: opts }) {
+    const { exit } = useApp();
+    const [state, setState] = useState({ phase: "checking" });
+    useEffect(() => {
+        async function loadSkills() {
+            // Check if logged in
+            const credentials = await getCredentials();
+            if (!credentials) {
+                setState({ phase: "not_logged_in" });
+                exit();
+                return;
+            }
+            const config = getConfig();
+            let skills = config.installed;
+            // Filter for outdated if requested (placeholder - would need version checking)
+            if (opts.outdated) {
+                // TODO: Implement actual outdated check against remote versions
+                skills = [];
+            }
+            setState({ phase: "success", skills });
+            exit();
+        }
+        loadSkills();
+    }, [opts.outdated, exit]);
+    switch (state.phase) {
+        case "checking":
+            return _jsx(Spinner, { text: "Loading..." });
+        case "not_logged_in":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StatusMessage, { type: "error", children: "Not authenticated" }), _jsx(Text, { dimColor: true, children: "Run 'skilluse login' to authenticate with GitHub" })] }));
+        case "success":
+            if (state.skills.length === 0) {
+                if (opts.outdated) {
+                    return (_jsx(Box, { flexDirection: "column", children: _jsx(StatusMessage, { type: "success", children: "All skills are up to date" }) }));
+                }
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Installed Skills" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "(no skills installed)" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Run 'skilluse install skill-name' to install one." }) })] }));
+            }
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Installed Skills" }), _jsx(Text, { children: " " }), state.skills.map((skill) => (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "cyan", bold: true, children: skill.name }), _jsxs(Text, { dimColor: true, children: [" v", skill.version] }), _jsxs(Text, { dimColor: true, children: [" (", skill.scope, ")"] })] }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["From: ", skill.repo, " | Path: ", skill.installedPath] }) })] }, skill.name)))] }));
+        case "error":
+            return _jsx(StatusMessage, { type: "error", children: state.message });
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/login.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const options: z.ZodObject<{
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force: boolean;
+}, {
+    force?: boolean | undefined;
+}>;
+interface Props {
+    options: z.infer<typeof options>;
+}
+export default function Login({ options: opts }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=login.d.ts.map