agentxchain 0.1.1 → 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.1",
+  "version": "0.1.2",
   "description": "CLI for AgentXchain — multi-agent coordination in your IDE",
   "type": "module",
   "bin": {

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/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('');
+  }
+}