skilluse 0.1.0

package/dist/services/store.d.ts

@@ -0,0 +1,64 @@
+export interface RepoConfig {
+    repo: string;
+    branch: string;
+    paths: string[];
+}
+export interface InstalledSkill {
+    name: string;
+    repo: string;
+    repoPath: string;
+    commitSha: string;
+    version: string;
+    type: string;
+    installedPath: string;
+    scope: "local" | "global";
+}
+/**
+ * Stored installation info (metadata, not secret)
+ * Simplified version of the OAuth Installation type
+ */
+export interface StoredInstallation {
+    id: number;
+    account: string;
+    accountType: "User" | "Organization";
+    repositorySelection: "all" | "selected";
+}
+export interface Config {
+    defaultRepo: string | null;
+    repos: RepoConfig[];
+    installed: InstalledSkill[];
+    installations: StoredInstallation[];
+    defaultInstallationId: number | null;
+}
+export declare function getConfig(): Config;
+export declare function addRepo(repo: RepoConfig): void;
+export declare function removeRepo(repoName: string): void;
+export declare function setDefaultRepo(repoName: string): void;
+export declare function addInstalledSkill(skill: InstalledSkill): void;
+export declare function removeInstalledSkill(name: string): void;
+/**
+ * Store the list of GitHub App installations the user has access to.
+ */
+export declare function setInstallations(installations: StoredInstallation[]): void;
+/**
+ * Get the list of stored GitHub App installations.
+ */
+export declare function getInstallations(): StoredInstallation[];
+/**
+ * Set the default installation ID for operations.
+ */
+export declare function setDefaultInstallation(installationId: number): void;
+/**
+ * Get the default installation ID.
+ */
+export declare function getDefaultInstallation(): number | null;
+/**
+ * Clear all installation-related data.
+ */
+export declare function clearInstallations(): void;
+/**
+ * Check if this is a first run (no repos configured).
+ * Used to show onboarding flow for new users.
+ */
+export declare function isFirstRun(): boolean;
+//# sourceMappingURL=store.d.ts.map

package/dist/services/store.js

@@ -0,0 +1,107 @@
+import Conf from "conf";
+import { configPath } from "./paths.js";
+const defaultConfig = {
+    defaultRepo: null,
+    repos: [],
+    installed: [],
+    installations: [],
+    defaultInstallationId: null,
+};
+const store = new Conf({
+    projectName: "skilluse",
+    cwd: configPath,
+    defaults: defaultConfig,
+});
+export function getConfig() {
+    return {
+        defaultRepo: store.get("defaultRepo"),
+        repos: store.get("repos"),
+        installed: store.get("installed"),
+        installations: store.get("installations"),
+        defaultInstallationId: store.get("defaultInstallationId"),
+    };
+}
+export function addRepo(repo) {
+    const repos = store.get("repos");
+    const existingIndex = repos.findIndex((r) => r.repo === repo.repo);
+    if (existingIndex >= 0) {
+        repos[existingIndex] = repo;
+    }
+    else {
+        repos.push(repo);
+    }
+    store.set("repos", repos);
+}
+export function removeRepo(repoName) {
+    const repos = store.get("repos");
+    const filtered = repos.filter((r) => r.repo !== repoName);
+    store.set("repos", filtered);
+    if (store.get("defaultRepo") === repoName) {
+        store.set("defaultRepo", null);
+    }
+}
+export function setDefaultRepo(repoName) {
+    store.set("defaultRepo", repoName);
+}
+export function addInstalledSkill(skill) {
+    const installed = store.get("installed");
+    const existingIndex = installed.findIndex((s) => s.name === skill.name);
+    if (existingIndex >= 0) {
+        installed[existingIndex] = skill;
+    }
+    else {
+        installed.push(skill);
+    }
+    store.set("installed", installed);
+}
+export function removeInstalledSkill(name) {
+    const installed = store.get("installed");
+    const filtered = installed.filter((s) => s.name !== name);
+    store.set("installed", filtered);
+}
+// ============================================================================
+// GitHub App Installation Management
+// ============================================================================
+/**
+ * Store the list of GitHub App installations the user has access to.
+ */
+export function setInstallations(installations) {
+    store.set("installations", installations);
+}
+/**
+ * Get the list of stored GitHub App installations.
+ */
+export function getInstallations() {
+    return store.get("installations");
+}
+/**
+ * Set the default installation ID for operations.
+ */
+export function setDefaultInstallation(installationId) {
+    store.set("defaultInstallationId", installationId);
+}
+/**
+ * Get the default installation ID.
+ */
+export function getDefaultInstallation() {
+    return store.get("defaultInstallationId");
+}
+/**
+ * Clear all installation-related data.
+ */
+export function clearInstallations() {
+    store.set("installations", []);
+    store.set("defaultInstallationId", null);
+}
+// ============================================================================
+// First-Run Detection
+// ============================================================================
+/**
+ * Check if this is a first run (no repos configured).
+ * Used to show onboarding flow for new users.
+ */
+export function isFirstRun() {
+    const repos = store.get("repos");
+    return repos.length === 0;
+}
+//# sourceMappingURL=store.js.map

package/dist/services/update.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Update notification service.
+ * Checks npm registry for newer versions with daily caching.
+ */
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion: string;
+    hasUpdate: boolean;
+}
+/**
+ * Check if a newer version is available.
+ * Uses cached result if checked within the last 24 hours.
+ * Returns null if check fails or is cached.
+ */
+export declare function checkForUpdate(): Promise<UpdateInfo | null>;
+/**
+ * Get the current CLI version.
+ */
+export declare function getCurrentVersion(): string;
+//# sourceMappingURL=update.d.ts.map

package/dist/services/update.js

@@ -0,0 +1,93 @@
+/**
+ * Update notification service.
+ * Checks npm registry for newer versions with daily caching.
+ */
+import Conf from "conf";
+import { configPath } from "./paths.js";
+import pkg from "../../package.json" with { type: "json" };
+// Current version from package.json
+const CURRENT_VERSION = pkg.version;
+// Cache check for 24 hours (in milliseconds)
+const CACHE_DURATION = 24 * 60 * 60 * 1000;
+const cache = new Conf({
+    projectName: "skilluse-update",
+    cwd: configPath,
+    defaults: {
+        lastCheck: 0,
+        latestVersion: null,
+    },
+});
+/**
+ * Check if a newer version is available.
+ * Uses cached result if checked within the last 24 hours.
+ * Returns null if check fails or is cached.
+ */
+export async function checkForUpdate() {
+    const lastCheck = cache.get("lastCheck");
+    const cachedVersion = cache.get("latestVersion");
+    const now = Date.now();
+    // Return cached result if still valid
+    if (lastCheck && now - lastCheck < CACHE_DURATION && cachedVersion) {
+        return {
+            currentVersion: CURRENT_VERSION,
+            latestVersion: cachedVersion,
+            hasUpdate: compareVersions(cachedVersion, CURRENT_VERSION) > 0,
+        };
+    }
+    // Fetch latest version from npm (non-blocking)
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000); // 3 second timeout
+        const response = await fetch("https://registry.npmjs.org/skilluse/latest", {
+            signal: controller.signal,
+            headers: {
+                Accept: "application/json",
+            },
+        });
+        clearTimeout(timeout);
+        if (!response.ok) {
+            // Package might not be published yet - cache null result
+            cache.set("lastCheck", now);
+            cache.set("latestVersion", null);
+            return null;
+        }
+        const data = (await response.json());
+        const latestVersion = data.version;
+        // Cache the result
+        cache.set("lastCheck", now);
+        cache.set("latestVersion", latestVersion);
+        return {
+            currentVersion: CURRENT_VERSION,
+            latestVersion,
+            hasUpdate: compareVersions(latestVersion, CURRENT_VERSION) > 0,
+        };
+    }
+    catch {
+        // Network error or timeout - don't cache, try again next time
+        return null;
+    }
+}
+/**
+ * Compare two semver versions.
+ * Returns: 1 if a > b, -1 if a < b, 0 if equal
+ */
+function compareVersions(a, b) {
+    const partsA = a.split(".").map(Number);
+    const partsB = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA > numB)
+            return 1;
+        if (numA < numB)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Get the current CLI version.
+ */
+export function getCurrentVersion() {
+    return CURRENT_VERSION;
+}
+//# sourceMappingURL=update.js.map

package/package.json

@@ -0,0 +1,70 @@
+{
+	"name": "skilluse",
+	"version": "0.1.0",
+	"description": "CLI tool for managing and installing AI Coding Agent Skills",
+	"main": "dist/index.js",
+	"bin": {
+		"skilluse": "./dist/index.js"
+	},
+	"files": [
+		"dist/**/*.js",
+		"dist/**/*.d.ts",
+		"README.md"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/jiweiyuan/skilluse.git",
+		"directory": "packages/cli"
+	},
+	"homepage": "https://github.com/jiweiyuan/skilluse",
+	"bugs": {
+		"url": "https://github.com/jiweiyuan/skilluse/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"dev": "bun --watch src/index.tsx",
+		"build": "bun build src/index.tsx --outdir dist --target node --external react-devtools-core",
+		"build:bin": "bun build src/cli.tsx --compile --minify --sourcemap --define 'process.env.DEV=\"false\"' --outfile dist/skilluse",
+		"build:all": "bun run scripts/build-all.ts",
+		"typecheck": "tsc --noEmit",
+		"format": "biome format --write .",
+		"lint": "biome lint .",
+		"check": "biome check .",
+		"start": "bun dist/index.js",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"cli",
+		"skills",
+		"claude-code",
+		"codex",
+		"ai-agent"
+	],
+	"author": "",
+	"license": "MIT",
+	"dependencies": {
+		"conf": "^15.0.2",
+		"env-paths": "^3.0.0",
+		"figures": "^6.1.0",
+		"ink": "^5.2.1",
+		"ink-select-input": "^6.2.0",
+		"ink-spinner": "^5.0.0",
+		"ink-text-input": "^6.0.0",
+		"pastel": "^2.0.0",
+		"react": "^18.2.0",
+		"zod": "^3.22.4"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.10",
+		"@types/node": "^22.10.2",
+		"@types/react": "^18.2.45",
+		"react-devtools-core": "^7.0.1",
+		"typescript": "^5.7.2"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"type": "module"
+}