agentxchain 0.1.0 → 0.1.2

package/README.md

@@ -58,6 +58,33 @@ For Cursor Cloud Agents, set `CURSOR_API_KEY` in your environment. Without it, t
 
 Stop all running agent sessions. Reads `.agentxchain-session.json` to find active agents.
 
+### `agentxchain config`
+
+View or edit project configuration.
+
+- `--add-agent` — interactively add a new agent
+- `--remove-agent <id>` — remove an agent by ID
+- `--set "<key> <value>"` — update a setting (e.g. `--set "rules.max_consecutive_claims 3"`)
+- `-j, --json` — output config as JSON
+
+Examples:
+
+```bash
+agentxchain config                              # show current config
+agentxchain config --add-agent                  # add a new agent
+agentxchain config --remove-agent ux            # remove the ux agent
+agentxchain config --set "project My New Name"  # change project name
+agentxchain config --set "rules.compress_after_words 8000"
+```
+
+### `agentxchain update`
+
+Update the CLI to the latest version from npm.
+
+```bash
+agentxchain update
+```
+
 ## How it works
 
 AgentXchain uses a **claim-based protocol**:

package/bin/agentxchain.js

@@ -1,28 +1,29 @@
 #!/usr/bin/env node
 
 import { Command } from 'commander';
-import chalk from 'chalk';
 import { initCommand } from '../src/commands/init.js';
 import { statusCommand } from '../src/commands/status.js';
 import { startCommand } from '../src/commands/start.js';
 import { stopCommand } from '../src/commands/stop.js';
+import { configCommand } from '../src/commands/config.js';
+import { updateCommand } from '../src/commands/update.js';
 
 const program = new Command();
 
 program
   .name('agentxchain')
   .description('Multi-agent coordination in your IDE')
-  .version('0.1.0');
+  .version('0.1.1');
 
 program
   .command('init')
-  .description('Initialize a new AgentXchain project')
+  .description('Create a new AgentXchain project folder')
   .option('-y, --yes', 'Skip prompts, use defaults')
   .action(initCommand);
 
 program
   .command('status')
-  .description('Show current lock status, phase, and agents')
+  .description('Show lock status, phase, and agents')
   .option('-j, --json', 'Output as JSON')
   .action(statusCommand);
 
@@ -39,4 +40,18 @@ program
   .description('Stop all running agent sessions')
   .action(stopCommand);
 
+program
+  .command('config')
+  .description('View or edit project configuration')
+  .option('--add-agent', 'Add a new agent interactively')
+  .option('--remove-agent <id>', 'Remove an agent by ID')
+  .option('--set <key_value>', 'Set a config value (e.g. --set "rules.max_consecutive_claims 3")')
+  .option('-j, --json', 'Output config as JSON')
+  .action(configCommand);
+
+program
+  .command('update')
+  .description('Update agentxchain CLI to the latest version')
+  .action(updateCommand);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for AgentXchain — multi-agent coordination in your IDE",
   "type": "module",
   "bin": {
@@ -16,7 +16,17 @@
     "build:macos": "bun build bin/agentxchain.js --compile --target=bun-darwin-arm64 --outfile=dist/agentxchain-macos-arm64",
     "build:linux": "bun build bin/agentxchain.js --compile --target=bun-linux-x64 --outfile=dist/agentxchain-linux-x64"
   },
-  "keywords": ["ai", "agents", "multi-agent", "coordination", "sdlc", "cursor", "vscode", "claude-code", "agentxchain"],
+  "keywords": [
+    "ai",
+    "agents",
+    "multi-agent",
+    "coordination",
+    "sdlc",
+    "cursor",
+    "vscode",
+    "claude-code",
+    "agentxchain"
+  ],
   "author": "shivamtiwari93",
   "license": "MIT",
   "repository": {

package/src/commands/config.js

@@ -0,0 +1,148 @@
+import { readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { loadConfig, CONFIG_FILE } from '../lib/config.js';
+
+export async function configCommand(opts) {
+  const result = loadConfig();
+  if (!result) {
+    console.log(chalk.red('  No agentxchain.json found. Run `agentxchain init` first.'));
+    process.exit(1);
+  }
+
+  const { root, config } = result;
+  const configPath = join(root, CONFIG_FILE);
+
+  if (opts.addAgent) {
+    await addAgent(config, configPath);
+    return;
+  }
+
+  if (opts.removeAgent) {
+    removeAgent(config, configPath, opts.removeAgent);
+    return;
+  }
+
+  if (opts.set) {
+    setSetting(config, configPath, opts.set);
+    return;
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify(config, null, 2));
+    return;
+  }
+
+  printConfig(config);
+}
+
+function printConfig(config) {
+  console.log('');
+  console.log(chalk.bold('  AgentXchain Config'));
+  console.log(chalk.dim('  ' + '─'.repeat(40)));
+  console.log('');
+  console.log(`  ${chalk.dim('Project:')}  ${config.project}`);
+  console.log(`  ${chalk.dim('Version:')}  ${config.version}`);
+  console.log(`  ${chalk.dim('Log:')}      ${config.log}`);
+  console.log('');
+
+  console.log(`  ${chalk.dim('Rules:')}`);
+  for (const [key, val] of Object.entries(config.rules || {})) {
+    console.log(`    ${chalk.dim(key + ':')} ${val}`);
+  }
+  console.log('');
+
+  console.log(`  ${chalk.dim('Agents:')}   ${Object.keys(config.agents).length}`);
+  for (const [id, agent] of Object.entries(config.agents)) {
+    console.log(`    ${chalk.cyan(id)} — ${agent.name}`);
+    console.log(`    ${chalk.dim(agent.mandate.slice(0, 80))}${agent.mandate.length > 80 ? '...' : ''}`);
+    console.log('');
+  }
+
+  console.log(chalk.dim('  Commands:'));
+  console.log(`    ${chalk.bold('agentxchain config --add-agent')}        Add a new agent`);
+  console.log(`    ${chalk.bold('agentxchain config --remove-agent <id>')} Remove an agent`);
+  console.log(`    ${chalk.bold('agentxchain config --set <key> <val>')}   Update a setting`);
+  console.log(`    ${chalk.bold('agentxchain config --json')}              Output as JSON`);
+  console.log('');
+}
+
+async function addAgent(config, configPath) {
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'id',
+      message: 'Agent ID (lowercase, no spaces):',
+      validate: (val) => {
+        if (!val.match(/^[a-z0-9-]+$/)) return 'Use lowercase letters, numbers, and hyphens only.';
+        if (config.agents[val]) return `Agent "${val}" already exists.`;
+        return true;
+      }
+    },
+    { type: 'input', name: 'name', message: 'Display name:' },
+    { type: 'input', name: 'mandate', message: 'Mandate (what this agent does):' }
+  ]);
+
+  config.agents[answers.id] = { name: answers.name, mandate: answers.mandate };
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+
+  console.log('');
+  console.log(chalk.green(`  ✓ Added agent ${chalk.bold(answers.id)} (${answers.name})`));
+  console.log(`  ${chalk.dim('Agents now:')} ${Object.keys(config.agents).join(', ')}`);
+  console.log('');
+}
+
+function removeAgent(config, configPath, id) {
+  if (!config.agents[id]) {
+    console.log(chalk.red(`  Agent "${id}" not found.`));
+    console.log(`  ${chalk.dim('Available:')} ${Object.keys(config.agents).join(', ')}`);
+    process.exit(1);
+  }
+
+  const name = config.agents[id].name;
+  delete config.agents[id];
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+
+  console.log('');
+  console.log(chalk.green(`  ✓ Removed agent ${chalk.bold(id)} (${name})`));
+  console.log(`  ${chalk.dim('Agents now:')} ${Object.keys(config.agents).join(', ')}`);
+  console.log('');
+}
+
+function setSetting(config, configPath, keyValPair) {
+  const parts = keyValPair.split(/\s+/);
+  if (parts.length < 2) {
+    console.log(chalk.red('  Usage: agentxchain config --set <key> <value>'));
+    console.log(chalk.dim('  Example: agentxchain config --set rules.max_consecutive_claims 3'));
+    process.exit(1);
+  }
+
+  const key = parts[0];
+  const rawVal = parts.slice(1).join(' ');
+  const segments = key.split('.');
+
+  let target = config;
+  for (let i = 0; i < segments.length - 1; i++) {
+    if (target[segments[i]] === undefined) {
+      target[segments[i]] = {};
+    }
+    target = target[segments[i]];
+  }
+
+  const lastKey = segments[segments.length - 1];
+  const oldVal = target[lastKey];
+
+  let val = rawVal;
+  if (rawVal === 'true') val = true;
+  else if (rawVal === 'false') val = false;
+  else if (!isNaN(rawVal) && rawVal !== '') val = Number(rawVal);
+
+  target[lastKey] = val;
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+
+  console.log('');
+  console.log(chalk.green(`  ✓ Set ${chalk.bold(key)} = ${val}`));
+  if (oldVal !== undefined) console.log(chalk.dim(`    (was: ${oldVal})`));
+  console.log('');
+}

package/src/commands/init.js

@@ -1,5 +1,5 @@
 import { writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { join, resolve } from 'path';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { CONFIG_FILE, LOCK_FILE, STATE_FILE } from '../lib/config.js';
@@ -23,46 +23,48 @@ const DEFAULT_AGENTS = {
   }
 };
 
-export async function initCommand(opts) {
-  const dir = process.cwd();
-
-  if (existsSync(join(dir, CONFIG_FILE)) && !opts.yes) {
-    const { overwrite } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'overwrite',
-      message: `${CONFIG_FILE} already exists. Overwrite?`,
-      default: false
-    }]);
-    if (!overwrite) {
-      console.log(chalk.yellow('Aborted.'));
-      return;
-    }
-  }
+function slugify(name) {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '');
+}
 
-  let project, agents;
+export async function initCommand(opts) {
+  let project, agents, folderName;
 
   if (opts.yes) {
     project = 'My AgentXchain project';
     agents = DEFAULT_AGENTS;
+    folderName = slugify(project);
   } else {
-    const answers = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'project',
-        message: 'Project name (one line):',
-        default: 'My AgentXchain project'
-      },
-      {
-        type: 'confirm',
-        name: 'useDefaults',
-        message: `Use default agents (pm, dev, qa, ux)?`,
-        default: true
-      }
-    ]);
+    const nameAnswer = await inquirer.prompt([{
+      type: 'input',
+      name: 'project',
+      message: 'Project name:',
+      default: 'My AgentXchain project'
+    }]);
+
+    project = nameAnswer.project;
+    folderName = slugify(project);
+
+    const folderAnswer = await inquirer.prompt([{
+      type: 'input',
+      name: 'folder',
+      message: 'Folder name:',
+      default: folderName
+    }]);
 
-    project = answers.project;
+    folderName = folderAnswer.folder;
 
-    if (answers.useDefaults) {
+    const agentAnswer = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'useDefaults',
+      message: 'Use default agents (pm, dev, qa, ux)?',
+      default: true
+    }]);
+
+    if (agentAnswer.useDefaults) {
       agents = DEFAULT_AGENTS;
     } else {
       agents = {};
@@ -80,6 +82,27 @@ export async function initCommand(opts) {
     }
   }
 
+  const dir = resolve(process.cwd(), folderName);
+
+  if (existsSync(dir)) {
+    if (existsSync(join(dir, CONFIG_FILE))) {
+      if (!opts.yes) {
+        const { overwrite } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'overwrite',
+          message: `${folderName}/ already has an agentxchain.json. Overwrite?`,
+          default: false
+        }]);
+        if (!overwrite) {
+          console.log(chalk.yellow('  Aborted.'));
+          return;
+        }
+      }
+    }
+  } else {
+    mkdirSync(dir, { recursive: true });
+  }
+
   const config = {
     version: 3,
     project,
@@ -109,27 +132,20 @@ export async function initCommand(opts) {
   writeFileSync(join(dir, CONFIG_FILE), JSON.stringify(config, null, 2) + '\n');
   writeFileSync(join(dir, LOCK_FILE), JSON.stringify(lock, null, 2) + '\n');
   writeFileSync(join(dir, STATE_FILE), JSON.stringify(state, null, 2) + '\n');
-
-  const logFile = config.log;
-  if (!existsSync(join(dir, logFile))) {
-    writeFileSync(join(dir, logFile), `# ${project} — Agent Log\n\n## COMPRESSED CONTEXT\n\n(No compressed context yet.)\n\n## MESSAGE LOG\n\n(Agents append messages below this line.)\n`);
-  }
-
-  if (!existsSync(join(dir, 'HUMAN_TASKS.md'))) {
-    writeFileSync(join(dir, 'HUMAN_TASKS.md'), '# Human Tasks\n\n(Agents append tasks here when they need human action.)\n');
-  }
+  writeFileSync(join(dir, config.log), `# ${project} — Agent Log\n\n## COMPRESSED CONTEXT\n\n(No compressed context yet.)\n\n## MESSAGE LOG\n\n(Agents append messages below this line.)\n`);
+  writeFileSync(join(dir, 'HUMAN_TASKS.md'), '# Human Tasks\n\n(Agents append tasks here when they need human action.)\n');
 
   console.log('');
-  console.log(chalk.green('  AgentXchain project initialized.'));
+  console.log(chalk.green(`  ✓ Created ${chalk.bold(folderName)}/`));
   console.log('');
-  console.log(`  ${chalk.dim('Config:')}   ${CONFIG_FILE}`);
-  console.log(`  ${chalk.dim('Lock:')}     ${LOCK_FILE}`);
-  console.log(`  ${chalk.dim('State:')}    ${STATE_FILE}`);
-  console.log(`  ${chalk.dim('Log:')}      ${logFile}`);
-  console.log(`  ${chalk.dim('Tasks:')}    HUMAN_TASKS.md`);
+  console.log(`    ${chalk.dim('├──')} ${CONFIG_FILE}`);
+  console.log(`    ${chalk.dim('├──')} ${LOCK_FILE}`);
+  console.log(`    ${chalk.dim('├──')} ${STATE_FILE}`);
+  console.log(`    ${chalk.dim('├──')} ${config.log}`);
+  console.log(`    ${chalk.dim('└──')} HUMAN_TASKS.md`);
   console.log('');
-  console.log(`  ${chalk.dim('Agents:')}   ${Object.keys(agents).join(', ')}`);
+  console.log(`  ${chalk.dim('Agents:')} ${Object.keys(agents).join(', ')}`);
   console.log('');
-  console.log(`  ${chalk.cyan('Next:')} Run ${chalk.bold('agentxchain start')} to launch agents in your IDE.`);
+  console.log(`  ${chalk.cyan('Next:')} ${chalk.bold(`cd ${folderName}`)} && ${chalk.bold('agentxchain start')}`);
   console.log('');
 }

package/src/commands/update.js

@@ -0,0 +1,42 @@
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+
+export async function updateCommand() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf8'));
+  const currentVersion = pkg.version;
+
+  console.log('');
+  console.log(`  ${chalk.dim('Current version:')} ${currentVersion}`);
+  console.log(`  ${chalk.dim('Checking npm for latest...')}`);
+
+  try {
+    const latest = execSync('npm view agentxchain version', { encoding: 'utf8' }).trim();
+
+    if (latest === currentVersion) {
+      console.log(chalk.green(`  ✓ Already on the latest version (${currentVersion}).`));
+      console.log('');
+      return;
+    }
+
+    console.log(`  ${chalk.dim('Latest version:')}  ${chalk.cyan(latest)}`);
+    console.log('');
+    console.log(`  Updating...`);
+
+    execSync('npm install -g agentxchain@latest', { stdio: 'inherit' });
+
+    console.log('');
+    console.log(chalk.green(`  ✓ Updated to ${latest}`));
+    console.log('');
+  } catch (err) {
+    console.log('');
+    console.log(chalk.yellow('  Could not auto-update. Run manually:'));
+    console.log(`    ${chalk.bold('npm install -g agentxchain@latest')}`);
+    console.log('');
+    console.log(chalk.dim(`  Error: ${err.message}`));
+    console.log('');
+  }
+}