feat: add gitclaw runner for run command

Creates temp workspace with full gitclaw directory structure
(agent.yaml, SOUL.md, RULES.md, skills/, tools/, hooks/, knowledge/)
and launches gitclaw CLI. Supports interactive and single-shot mode.

Uses process.exitCode (not process.exit) for proper cleanup.

Author: shreyas-lyzr

src/commands/run.ts

@@ -14,6 +14,7 @@ import { runWithGitHub } from '../runners/github.js';
 import { runWithGit } from '../runners/git.js';
 import { runWithOpenCode } from '../runners/opencode.js';
 import { runWithGemini } from '../runners/gemini.js';
+import { runWithGitclaw } from '../runners/gitclaw.js';
 
 interface RunOptions {
   repo?: string;
@@ -28,7 +29,7 @@ interface RunOptions {
 export const runCommand = new Command('run')
   .description('Run an agent from a git repository or local directory')
   .option('-r, --repo <url>', 'Git repository URL')
-  .option('-a, --adapter <name>', 'Adapter: claude, openai, crewai, openclaw, nanobot, lyzr, github, opencode, gemini, git, prompt', 'claude')
+  .option('-a, --adapter <name>', 'Adapter: claude, openai, crewai, openclaw, nanobot, lyzr, github, opencode, gemini, gitclaw, git, prompt', 'claude')
   .option('-b, --branch <branch>', 'Git branch/tag to clone', 'main')
   .option('--refresh', 'Force re-clone (pull latest)', false)
   .option('--no-cache', 'Clone to temp dir, delete on exit')
@@ -120,6 +121,9 @@ export const runCommand = new Command('run')
         case 'gemini':
           runWithGemini(agentDir, manifest, { prompt: options.prompt });
           break;
+        case 'gitclaw':
+          runWithGitclaw(agentDir, manifest, { prompt: options.prompt });
+          break;
         case 'git':
           if (!options.repo) {
             error('The git adapter requires --repo (-r)');
@@ -138,7 +142,7 @@ export const runCommand = new Command('run')
           break;
         default:
           error(`Unknown adapter: ${options.adapter}`);
-          info('Supported adapters: claude, openai, crewai, openclaw, nanobot, lyzr, github, opencode, gemini, git, prompt');
+          info('Supported adapters: claude, openai, crewai, openclaw, nanobot, lyzr, github, opencode, gemini, gitclaw, git, prompt');
           process.exit(1);
       }
     } catch (e) {

src/runners/gitclaw.ts

@@ -0,0 +1,105 @@
+import { writeFileSync, mkdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { exportToGitclaw } from '../adapters/gitclaw.js';
+import { AgentManifest } from '../utils/loader.js';
+import { error, info } from '../utils/format.js';
+
+export interface GitclawRunOptions {
+  prompt?: string;
+}
+
+/**
+ * Run a gitagent agent using the gitclaw SDK.
+ *
+ * Creates a temporary workspace with the full gitclaw directory structure:
+ *   - agent.yaml (provider:model format)
+ *   - SOUL.md, RULES.md, DUTIES.md
+ *   - skills/, tools/, hooks/, knowledge/
+ *
+ * Then launches `gitclaw` CLI in that workspace.
+ * Supports both interactive mode (no prompt) and single-shot mode (`gitclaw run -p`).
+ */
+export function runWithGitclaw(agentDir: string, manifest: AgentManifest, options: GitclawRunOptions = {}): void {
+  const exp = exportToGitclaw(agentDir);
+
+  // Create a temporary workspace
+  const workspaceDir = join(tmpdir(), `gitagent-gitclaw-${randomBytes(4).toString('hex')}`);
+  mkdirSync(workspaceDir, { recursive: true });
+
+  // Write agent.yaml
+  writeFileSync(join(workspaceDir, 'agent.yaml'), exp.agentYaml, 'utf-8');
+
+  // Write identity files
+  if (exp.soulMd) writeFileSync(join(workspaceDir, 'SOUL.md'), exp.soulMd, 'utf-8');
+  if (exp.rulesMd) writeFileSync(join(workspaceDir, 'RULES.md'), exp.rulesMd, 'utf-8');
+  if (exp.dutiesMd) writeFileSync(join(workspaceDir, 'DUTIES.md'), exp.dutiesMd, 'utf-8');
+
+  // Write knowledge index
+  if (exp.knowledgeIndex) {
+    mkdirSync(join(workspaceDir, 'knowledge'), { recursive: true });
+    writeFileSync(join(workspaceDir, 'knowledge', 'index.yaml'), exp.knowledgeIndex, 'utf-8');
+  }
+
+  // Write skills
+  for (const skill of exp.skills) {
+    const skillDir = join(workspaceDir, 'skills', skill.name);
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, 'SKILL.md'), skill.content, 'utf-8');
+  }
+
+  // Write tools
+  if (exp.tools.length > 0) {
+    mkdirSync(join(workspaceDir, 'tools'), { recursive: true });
+    for (const tool of exp.tools) {
+      writeFileSync(join(workspaceDir, 'tools', tool.name), tool.content, 'utf-8');
+    }
+  }
+
+  // Write hooks
+  if (exp.hooks) {
+    mkdirSync(join(workspaceDir, 'hooks'), { recursive: true });
+    writeFileSync(join(workspaceDir, 'hooks', 'hooks.yaml'), exp.hooks, 'utf-8');
+  }
+
+  info(`Workspace prepared at ${workspaceDir}`);
+  info(`  agent.yaml${exp.soulMd ? ', SOUL.md' : ''}${exp.rulesMd ? ', RULES.md' : ''}`);
+  if (exp.skills.length > 0) {
+    info(`  Skills: ${exp.skills.map(s => s.name).join(', ')}`);
+  }
+  if (manifest.model?.preferred) {
+    info(`  Model: ${manifest.model.preferred}`);
+  }
+
+  // Build gitclaw CLI args
+  const args: string[] = [];
+
+  if (options.prompt) {
+    args.push('run', '-p', options.prompt);
+  }
+
+  info(`Launching gitclaw agent "${manifest.name}"...`);
+  if (!options.prompt) {
+    info('Starting interactive mode. Type your messages to chat.');
+  }
+
+  const result = spawnSync('gitclaw', args, {
+    stdio: 'inherit',
+    cwd: workspaceDir,
+    env: { ...process.env },
+  });
+
+  // Cleanup temp workspace before exiting
+  try { rmSync(workspaceDir, { recursive: true, force: true }); } catch { /* ignore */ }
+
+  if (result.error) {
+    error(`Failed to launch gitclaw: ${result.error.message}`);
+    info('Make sure gitclaw is installed: npm install -g gitclaw');
+    process.exitCode = 1;
+    return;
+  }
+
+  process.exitCode = result.status ?? 0;
+}