@phnx-labs/agents-cli 0.1.0

package/dist/commands/fork.js

@@ -0,0 +1,139 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getAgentsDir, ensureAgentsDir } from '../lib/state.js';
+import { isGitRepo, isSystemRepoOrigin, getGitHubUsername, hasLocalChanges, setUpstreamRemote, setRemoteUrl, getRemoteUrl, } from '../lib/git.js';
+import { DEFAULT_SYSTEM_REPO, systemRepoSlug } from '../lib/types.js';
+import { isPromptCancelled } from './utils.js';
+export function registerForkCommand(program) {
+    program
+        .command('fork')
+        .description('Copy the default config repo to your own GitHub so you can push changes. Runs once after init.')
+        .addHelpText('after', `
+Examples:
+  # Fork the default repo to your GitHub account
+  agents fork
+
+When to use:
+  - You initialized with 'agents init' using the default config
+  - You've customized commands, skills, or settings
+  - You want to save your changes to your own GitHub repo
+
+What it does:
+  1. Creates a fork of the default repo under your GitHub account (gh:yourname/.agents)
+  2. Reconfigures remotes: origin -> your fork, upstream -> default repo
+  3. Commits any local changes you've made
+  4. Pushes everything to your new fork
+
+After forking:
+  - 'agents push' sends your changes to your fork
+  - 'agents pull --upstream' pulls updates from the default repo
+
+Requirements:
+  - GitHub CLI authenticated (run 'gh auth login' if needed)
+  - ~/.agents/ must be tracking the default repo (not already forked)
+`)
+        .action(async () => {
+        try {
+            const agentsDir = getAgentsDir();
+            ensureAgentsDir();
+            // Check if ~/.agents/ is a git repo
+            if (!isGitRepo(agentsDir)) {
+                console.log(chalk.yellow('~/.agents/ is not a git repository.'));
+                console.log(chalk.gray('\nInitialize first:'));
+                console.log(chalk.cyan('  agents pull'));
+                return;
+            }
+            // Check if already forked (origin is not system repo)
+            if (!await isSystemRepoOrigin(agentsDir)) {
+                const currentOrigin = await getRemoteUrl(agentsDir);
+                console.log(chalk.green('Already forked!'));
+                console.log(chalk.gray(`\nOrigin: ${currentOrigin}`));
+                console.log(chalk.gray('\nTo push your changes:'));
+                console.log(chalk.cyan('  agents push'));
+                console.log(chalk.gray('\nTo pull updates from system repo:'));
+                console.log(chalk.cyan('  agents pull --upstream'));
+                return;
+            }
+            // Get GitHub username
+            const spinner = ora('Checking GitHub...').start();
+            const username = await getGitHubUsername();
+            if (!username) {
+                spinner.fail('GitHub CLI not authenticated');
+                console.log(chalk.gray('\nTo authenticate:'));
+                console.log(chalk.cyan('  gh auth login'));
+                return;
+            }
+            spinner.succeed(`Logged in as ${username}`);
+            // Fork the system repo
+            const forkSpinner = ora('Forking system repo...').start();
+            const { exec } = await import('child_process');
+            const { promisify } = await import('util');
+            const execAsync = promisify(exec);
+            const repoSlug = systemRepoSlug(DEFAULT_SYSTEM_REPO);
+            try {
+                // gh repo fork creates a fork and optionally clones it
+                // We just want to create the fork on GitHub, not clone
+                await execAsync(`gh repo fork ${repoSlug} --clone=false`);
+                forkSpinner.succeed(`Forked to ${username}/.agents`);
+            }
+            catch (err) {
+                const errorMsg = err.message;
+                // Check if fork already exists
+                if (errorMsg.includes('already exists') || errorMsg.includes('409')) {
+                    forkSpinner.info(`Fork ${username}/.agents already exists`);
+                }
+                else {
+                    forkSpinner.fail(`Failed to fork: ${errorMsg}`);
+                    return;
+                }
+            }
+            // Reconfigure remotes
+            const remoteSpinner = ora('Reconfiguring remotes...').start();
+            // Set current origin as upstream
+            await setUpstreamRemote(agentsDir, `https://github.com/${repoSlug}.git`);
+            // Set user's fork as new origin
+            await setRemoteUrl(agentsDir, `https://github.com/${username}/.agents.git`);
+            remoteSpinner.succeed('Reconfigured remotes');
+            console.log(chalk.gray(`  origin   -> ${username}/.agents`));
+            console.log(chalk.gray(`  upstream -> ${repoSlug}`));
+            // Commit any local changes
+            if (await hasLocalChanges(agentsDir)) {
+                const commitSpinner = ora('Committing local changes...').start();
+                const simpleGit = (await import('simple-git')).default;
+                const git = simpleGit(agentsDir);
+                await git.add('-A');
+                await git.commit('Local changes before fork');
+                commitSpinner.succeed('Committed local changes');
+            }
+            // Push to new origin
+            const pushSpinner = ora('Pushing to your fork...').start();
+            try {
+                const simpleGit = (await import('simple-git')).default;
+                const git = simpleGit(agentsDir);
+                await git.push('origin', 'main', ['--set-upstream']);
+                pushSpinner.succeed('Pushed to your fork');
+            }
+            catch (err) {
+                pushSpinner.fail(`Push failed: ${err.message}`);
+                console.log(chalk.yellow('\nYou can push manually later:'));
+                console.log(chalk.cyan('  agents push'));
+                return;
+            }
+            console.log(chalk.green('\nFork complete!'));
+            console.log(chalk.gray(`\nView: https://github.com/${username}/.agents`));
+            console.log(chalk.gray('\nTo push future changes:'));
+            console.log(chalk.cyan('  agents push'));
+            console.log(chalk.gray('\nTo pull updates from system repo:'));
+            console.log(chalk.cyan('  agents pull --upstream'));
+        }
+        catch (err) {
+            if (isPromptCancelled(err)) {
+                console.log(chalk.yellow('\nCancelled'));
+                process.exit(0);
+            }
+            console.error(chalk.red(err.message));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=fork.js.map

package/dist/commands/fork.js.map

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

package/dist/commands/hooks.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerHooksCommands(program: Command): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/commands/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2tB5D"}