@phnx-labs/agents-cli 1.16.0 → 1.17.1

package/scripts/postinstall.js

@@ -9,7 +9,7 @@ import * as os from 'os';
 import * as readline from 'readline';
 
 const HOME = os.homedir();
-const SHIMS_DIR = path.join(HOME, '.agents-system', 'shims');
+const SHIMS_DIR = path.join(HOME, '.agents', '.cache', 'shims');
 const SYSTEM_DIR = path.join(HOME, '.agents-system');
 const USER_DIR = path.join(HOME, '.agents');
 
@@ -111,7 +111,8 @@ const exportLine = shellName === 'fish'
   ? `fish_add_path ${SHIMS_DIR}`
   : `export PATH="${SHIMS_DIR}:$PATH"`;
 
-const ALIASES = ['sessions', 'teams'];
+// Shorthands that delegate to `agents <name>` — written unconditionally on install.
+const ALIASES = ['sessions', 'secrets', 'browser', 'pty', 'teams'];
 
 function writeAliasShims() {
   const written = [];
@@ -124,6 +125,27 @@ function writeAliasShims() {
   return written;
 }
 
+function getVersion() {
+  const pkgPath = new URL('../package.json', import.meta.url).pathname;
+  try {
+    return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
+  } catch { return null; }
+}
+
+function getChangelogSection(version) {
+  const changelogPath = new URL('../CHANGELOG.md', import.meta.url).pathname;
+  if (!fs.existsSync(changelogPath)) return null;
+  const lines = fs.readFileSync(changelogPath, 'utf-8').split('\n');
+  let inSection = false;
+  const section = [];
+  for (const line of lines) {
+    if (line.startsWith(`## ${version}`)) { inSection = true; continue; }
+    if (inSection && line.startsWith('## ')) break;
+    if (inSection) section.push(line);
+  }
+  return section.length ? section.join('\n').trim() : null;
+}
+
 function ask(question) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -134,33 +156,18 @@ function ask(question) {
   });
 }
 
-async function promptForAliases() {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) return 'skip';
-  console.log(`
-Install bare-command aliases for common subcommands?
-This creates ${ALIASES.map((n) => `\`${n}\``).join(', ')} as wrappers in ${SHIMS_DIR}
-so you can type \`sessions\` instead of \`agents sessions\`.
-
-  1) Let's do it
-  2) Skip this time
-  3) I'll do it manually if needed
-`);
-  const answer = await ask('Choose [1/2/3] (default 1): ');
-  if (answer === '' || answer === '1') return 'install';
-  if (answer === '3') return 'manual';
-  return 'skip';
+function isAlreadyConfigured(rcFile) {
+  if (!fs.existsSync(rcFile)) return false;
+  const content = fs.readFileSync(rcFile, 'utf-8');
+  // Accept either the new path or the legacy ~/.agents-system/shims path
+  return content.includes('.agents/.cache/shims') || content.includes('.agents-system/shims');
 }
 
 async function main() {
   // Opt-in: AGENTS_INIT_SHELL=1 npm install -g @phnx-labs/agents-cli
   if (process.env.AGENTS_INIT_SHELL === '1') {
     const rcFile = getShellRc();
-    let alreadyConfigured = false;
-    if (fs.existsSync(rcFile)) {
-      const content = fs.readFileSync(rcFile, 'utf-8');
-      alreadyConfigured = content.includes('.agents-system/shims');
-    }
-    if (!alreadyConfigured) {
+    if (!isAlreadyConfigured(rcFile)) {
       const addition = `\n# agents-cli: version switching for AI coding agents\n${exportLine}\n`;
       fs.mkdirSync(path.dirname(rcFile), { recursive: true });
       fs.appendFileSync(rcFile, addition);
@@ -169,53 +176,47 @@ async function main() {
     }
     writeAliasShims();
     console.log(`  Installed bare-command aliases: ${ALIASES.join(', ')}\n`);
-    return;
-  }
-
-  // Default: offer to auto-add shims to PATH (like homebrew does)
-  const rcFile = getShellRc();
-  let alreadyConfigured = false;
-  if (fs.existsSync(rcFile)) {
-    const content = fs.readFileSync(rcFile, 'utf-8');
-    alreadyConfigured = content.includes('.agents-system/shims');
-  }
-
-  console.log(`\nagents-cli installed.`);
+  } else {
+    // Default: offer to auto-add shims to PATH (like homebrew does)
+    const rcFile = getShellRc();
 
-  if (!alreadyConfigured && process.stdin.isTTY && process.stdout.isTTY) {
-    const answer = await ask(`\nAdd shims to PATH in ~/${path.basename(rcFile)}? [Y/n] `);
-    if (answer === '' || answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
-      const addition = `\n# agents-cli: version switching for AI coding agents\n${exportLine}\n`;
-      fs.mkdirSync(path.dirname(rcFile), { recursive: true });
-      fs.appendFileSync(rcFile, addition);
-      console.log(`\n  Added ${SHIMS_DIR} to PATH in ${path.basename(rcFile)}`);
-      console.log(`  Restart your shell or run: source ~/${path.basename(rcFile)}\n`);
-    } else {
-      console.log(`
+    console.log(`\nagents-cli installed.`);
+
+    if (!isAlreadyConfigured(rcFile) && process.stdin.isTTY && process.stdout.isTTY) {
+      const answer = await ask(`\nAdd shims to PATH in ~/${path.basename(rcFile)}? [Y/n] `);
+      if (answer === '' || answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
+        const addition = `\n# agents-cli: version switching for AI coding agents\n${exportLine}\n`;
+        fs.mkdirSync(path.dirname(rcFile), { recursive: true });
+        fs.appendFileSync(rcFile, addition);
+        console.log(`\n  Added ${SHIMS_DIR} to PATH in ${path.basename(rcFile)}`);
+        console.log(`  Restart your shell or run: source ~/${path.basename(rcFile)}\n`);
+      } else {
+        console.log(`
 To enable version-aware shims, add this to your shell config:
 
   ${exportLine}
 `);
-    }
-  } else if (!alreadyConfigured) {
-    console.log(`
+      }
+    } else if (!isAlreadyConfigured(rcFile)) {
+      console.log(`
 To enable version-aware shims, add this to your shell config:
 
   ${exportLine}
 `);
-  }
+    }
 
-  const choice = await promptForAliases();
-  if (choice === 'install') {
     const written = writeAliasShims();
-    console.log(`\n  Installed aliases: ${written.join(', ')} (in ${SHIMS_DIR})`);
-    console.log(`  Make sure ${SHIMS_DIR} is on your PATH (see above).\n`);
-  } else if (choice === 'manual') {
-    console.log(`\n  To add aliases later, drop these in a directory on your PATH:`);
-    for (const name of ALIASES) {
-      console.log(`    ${name} -> exec agents ${name} "$@"`);
+    console.log(`  Installed shorthands: ${written.join(', ')}`);
+  }
+
+  const version = getVersion();
+  if (version) {
+    const section = getChangelogSection(version);
+    if (section) {
+      console.log(`\nWhat's new in ${version}:\n`);
+      console.log(section);
+      console.log('');
     }
-    console.log('');
   }
 }
 

package/dist/commands/fork.d.ts

@@ -1,10 +0,0 @@
-/**
- * Repository fork command.
- *
- * Registers the `agents fork` command which forks the default system
- * config repo to the user's GitHub account, reconfigures remotes
- * (origin -> user fork, upstream -> system repo), and pushes.
- */
-import type { Command } from 'commander';
-/** Register the `agents fork` command. */
-export declare function registerForkCommand(program: Command): void;

package/dist/commands/fork.js

@@ -1,146 +0,0 @@
-/**
- * Repository fork command.
- *
- * Registers the `agents fork` command which forks the default system
- * config repo to the user's GitHub account, reconfigures remotes
- * (origin -> user fork, upstream -> system repo), and pushes.
- */
-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';
-/** Register the `agents fork` command. */
-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 setup.')
-        .addHelpText('after', `
-Examples:
-  # Fork the default repo to your GitHub account
-  agents fork
-
-When to use:
-  - You set up with 'agents setup' 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 { execFile } = await import('child_process');
-            const { promisify } = await import('util');
-            const execFileAsync = promisify(execFile);
-            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 execFileAsync('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);
-        }
-    });
-}