@openagents-org/agent-launcher 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @openagents-org/agent-connector
+
+Agent management CLI and library for [OpenAgents](https://openagents.org) — install, configure, and run AI coding agents from your terminal.
+
+## Install
+
+```bash
+npm install -g @openagents-org/agent-connector
+```
+
+## CLI Usage
+
+```bash
+# Browse available agents
+agent-connector search
+
+# Install an agent runtime
+agent-connector install openclaw
+agent-connector install claude
+
+# Create and configure an agent
+agent-connector create my-agent --type openclaw
+agent-connector env openclaw --set LLM_API_KEY=sk-...
+agent-connector env openclaw --set LLM_BASE_URL=https://api.openai.com/v1
+
+# Start the daemon (runs agents in background)
+agent-connector up
+
+# Check status
+agent-connector status
+
+# View logs
+agent-connector logs
+
+# Connect to a workspace
+agent-connector connect my-agent <token>
+
+# Stop
+agent-connector down
+```
+
+Run `agent-connector help` for the full command list.
+
+## Library Usage
+
+```js
+const { AgentConnector } = require('@openagents-org/agent-connector');
+
+const connector = new AgentConnector();
+
+// Browse catalog
+const catalog = await connector.getCatalog();
+
+// Install a runtime
+await connector.install('openclaw');
+
+// Agent CRUD
+connector.addAgent({ name: 'my-agent', type: 'openclaw' });
+connector.saveAgentEnv('openclaw', { LLM_API_KEY: 'sk-...' });
+
+// Daemon lifecycle
+const daemon = connector.createDaemon();
+await daemon.start();
+```
+
+## Supported Agents
+
+| Agent | Type | Install |
+|-------|------|---------|
+| [OpenClaw](https://github.com/openagents/openclaw) | `openclaw` | npm |
+| [Claude Code](https://claude.ai/claude-code) | `claude` | npm |
+| [Codex](https://github.com/openai/codex) | `codex` | npm |
+| [Aider](https://aider.chat) | `aider` | curl |
+| [Goose](https://github.com/block/goose) | `goose` | curl |
+| [Amp](https://ampcode.com) | `amp` | curl |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | npm |
+| And more... | | |
+
+## Requirements
+
+- Node.js 18+
+- No Python required
+
+## License
+
+MIT

package/bin/agent-connector.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+
+require('../src/cli.js');

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@openagents-org/agent-launcher",
+  "version": "0.1.0",
+  "description": "OpenAgents Launcher — install, configure, and run AI coding agents from your terminal",
+  "main": "src/index.js",
+  "bin": {
+    "openagents": "bin/agent-connector.js",
+    "agent-connector": "bin/agent-connector.js"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "build:registry": "node scripts/build-registry.js",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "openagents",
+    "ai",
+    "agent",
+    "coding",
+    "cli",
+    "launcher"
+  ],
+  "author": "OpenAgents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openagents-org/openagents",
+    "directory": "packages/agent-connector"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "registry.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "blessed": "^0.1.81"
+  }
+}

package/registry.json

@@ -0,0 +1,457 @@
+[
+  {
+    "name": "aider",
+    "label": "Aider",
+    "description": "AI pair programming in your terminal",
+    "homepage": "https://aider.chat",
+    "tags": [
+      "coding",
+      "pair-programming",
+      "open-source"
+    ],
+    "install": {
+      "binary": "aider",
+      "macos": "curl -LsSf https://aider.chat/install.sh | sh",
+      "linux": "curl -LsSf https://aider.chat/install.sh | sh",
+      "windows": "powershell -c \\\"irm https://aider.chat/install.ps1 | iex\\\""
+    }
+  },
+  {
+    "name": "amp",
+    "label": "Amp (Sourcegraph)",
+    "description": "Sourcegraph's AI coding agent for CLI and VS Code",
+    "homepage": "https://ampcode.com",
+    "tags": [
+      "coding",
+      "sourcegraph",
+      "cli",
+      "vscode"
+    ],
+    "install": {
+      "binary": "amp",
+      "macos": "curl -fsSL https://ampcode.com/install.sh | bash",
+      "linux": "curl -fsSL https://ampcode.com/install.sh | bash",
+      "windows": "powershell -c \\\"irm https://ampcode.com/install.ps1 | iex\\\""
+    }
+  },
+  {
+    "name": "claude",
+    "label": "Claude Code CLI",
+    "description": "Anthropic's official CLI agent for Claude",
+    "homepage": "https://claude.ai/claude-code",
+    "tags": [
+      "coding",
+      "cli",
+      "anthropic"
+    ],
+    "builtin": true,
+    "install": {
+      "binary": "claude",
+      "requires": [
+        "nodejs",
+        "git"
+      ],
+      "macos": "npm install -g @anthropic-ai/claude-code",
+      "linux": "npm install -g @anthropic-ai/claude-code",
+      "windows": "npm install -g @anthropic-ai/claude-code"
+    },
+    "adapter": {
+      "module": "openagents.adapters.claude",
+      "class": "ClaudeAdapter"
+    },
+    "launch": {
+      "args": [
+        "--append-system-prompt",
+        "Your agent name is '{agent_name}'."
+      ]
+    },
+    "check_ready": {
+      "env_vars": [
+        "ANTHROPIC_API_KEY"
+      ],
+      "creds_file": "~/.claude/.credentials.json",
+      "creds_key": "claudeAiOauth",
+      "keychain_service": "Claude Code-credentials",
+      "not_ready_message": "Not logged in. Run: claude login",
+      "login_command": "claude login"
+    }
+  },
+  {
+    "name": "cline",
+    "label": "Cline",
+    "description": "Autonomous coding agent (VS Code extension)",
+    "homepage": "https://github.com/cline/cline",
+    "tags": [
+      "coding",
+      "vscode",
+      "autonomous"
+    ],
+    "install": {
+      "binary": "code",
+      "macos": "code --install-extension saoudrizwan.claude-dev",
+      "linux": "code --install-extension saoudrizwan.claude-dev",
+      "windows": "code --install-extension saoudrizwan.claude-dev"
+    }
+  },
+  {
+    "name": "codex",
+    "label": "OpenAI Codex CLI",
+    "description": "OpenAI's coding agent for the terminal",
+    "homepage": "https://github.com/openai/codex",
+    "tags": [
+      "coding",
+      "openai",
+      "cli"
+    ],
+    "builtin": true,
+    "install": {
+      "binary": "codex",
+      "requires": [
+        "nodejs"
+      ],
+      "macos": "npm install -g @openai/codex",
+      "linux": "npm install -g @openai/codex",
+      "windows": "npm install -g @openai/codex"
+    },
+    "adapter": {
+      "module": "openagents.adapters.codex",
+      "class": "CodexAdapter"
+    },
+    "launch": {
+      "args": [
+        null
+      ]
+    },
+    "env_config": [
+      {
+        "name": "OPENAI_API_KEY",
+        "description": "OpenAI API key",
+        "required": true,
+        "password": true
+      }
+    ],
+    "check_ready": {
+      "env_vars": [
+        "OPENAI_API_KEY"
+      ],
+      "saved_env_key": "OPENAI_API_KEY",
+      "not_ready_message": "No API key — press e to configure"
+    },
+    "resolve_env": {
+      "rules": [
+        {
+          "from": "LLM_API_KEY",
+          "to": "OPENAI_API_KEY"
+        },
+        {
+          "from": "LLM_BASE_URL",
+          "to": "OPENAI_BASE_URL"
+        },
+        {
+          "from": "LLM_MODEL",
+          "to": "CODEX_MODEL"
+        }
+      ]
+    }
+  },
+  {
+    "name": "copilot",
+    "label": "GitHub Copilot CLI",
+    "description": "GitHub Copilot coding agent for the terminal",
+    "homepage": "https://github.com/features/copilot",
+    "tags": [
+      "coding",
+      "github",
+      "cli"
+    ],
+    "install": {
+      "binary": "gh",
+      "macos": "gh extension install github/gh-copilot",
+      "linux": "gh extension install github/gh-copilot",
+      "windows": "gh extension install github/gh-copilot"
+    }
+  },
+  {
+    "name": "cursor",
+    "label": "Cursor",
+    "description": "AI-powered code editor with agent mode CLI",
+    "homepage": "https://cursor.com",
+    "tags": [
+      "coding",
+      "editor",
+      "cli",
+      "ai"
+    ],
+    "builtin": true,
+    "install": {
+      "binary": "cursor",
+      "requires": [
+        null
+      ],
+      "macos": "curl https://cursor.com/install -fsSL | bash",
+      "linux": "curl https://cursor.com/install -fsSL | bash",
+      "windows": "echo 'Download Cursor from https://cursor.com/downloads'"
+    },
+    "adapter": {
+      "module": "openagents.adapters.cursor",
+      "class": "CursorAdapter"
+    },
+    "launch": {
+      "args": [
+        null
+      ]
+    },
+    "env_config": [
+      {
+        "name": "OPENAI_API_KEY",
+        "description": "API key for LLM inference",
+        "required": true,
+        "password": true
+      }
+    ],
+    "check_ready": {
+      "env_vars": [
+        "OPENAI_API_KEY"
+      ],
+      "saved_env_key": "OPENAI_API_KEY",
+      "not_ready_message": "No API key — press e to configure"
+    },
+    "resolve_env": {
+      "rules": [
+        {
+          "from": "LLM_API_KEY",
+          "to": "OPENAI_API_KEY"
+        },
+        {
+          "from": "LLM_BASE_URL",
+          "to": "OPENAI_BASE_URL"
+        },
+        {
+          "from": "LLM_MODEL",
+          "to": "CURSOR_MODEL"
+        }
+      ]
+    }
+  },
+  {
+    "name": "gemini",
+    "label": "Gemini CLI",
+    "description": "Google's open-source AI agent for the command line",
+    "homepage": "https://github.com/google-gemini/gemini-cli",
+    "tags": [
+      "coding",
+      "google",
+      "open-source",
+      "cli"
+    ],
+    "install": {
+      "binary": "gemini",
+      "requires": [
+        "nodejs"
+      ],
+      "macos": "npm install -g @google/gemini-cli",
+      "linux": "npm install -g @google/gemini-cli",
+      "windows": "npm install -g @google/gemini-cli"
+    }
+  },
+  {
+    "name": "goose",
+    "label": "Goose",
+    "description": "An open-source AI developer agent by Block",
+    "homepage": "https://github.com/block/goose",
+    "tags": [
+      "coding",
+      "developer",
+      "open-source"
+    ],
+    "install": {
+      "binary": "goose",
+      "macos": "curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash",
+      "linux": "curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash",
+      "windows": "powershell -c \\\"irm https://raw.githubusercontent.com/block/goose/main/download_cli.ps1 | iex\\\""
+    }
+  },
+  {
+    "name": "nanoclaw",
+    "label": "NanoClaw",
+    "description": "Lightweight containerized coding agent built on Claude Agent SDK",
+    "homepage": "https://github.com/qwibitai/nanoclaw",
+    "tags": [
+      "coding",
+      "container",
+      "lightweight",
+      "open-source"
+    ],
+    "builtin": true,
+    "install": {
+      "binary": "nanoclaw",
+      "api_only": true,
+      "requires": [
+        "nodejs",
+        "git"
+      ],
+      "macos": "echo 'NanoClaw uses direct API mode — no binary install needed'",
+      "linux": "echo 'NanoClaw uses direct API mode — no binary install needed'",
+      "windows": "echo 'NanoClaw uses direct API mode — no binary install needed'"
+    },
+    "adapter": {
+      "module": "openagents.adapters.nanoclaw",
+      "class": "NanoClawAdapter"
+    },
+    "launch": {
+      "args": [
+        null
+      ]
+    },
+    "env_config": [
+      {
+        "name": "OPENAI_API_KEY",
+        "description": "API key for LLM inference",
+        "required": true,
+        "password": true
+      }
+    ],
+    "check_ready": {
+      "env_vars": [
+        "OPENAI_API_KEY"
+      ],
+      "saved_env_key": "OPENAI_API_KEY",
+      "not_ready_message": "No API key — press e to configure"
+    },
+    "resolve_env": {
+      "rules": [
+        {
+          "from": "LLM_API_KEY",
+          "to": "OPENAI_API_KEY"
+        },
+        {
+          "from": "LLM_BASE_URL",
+          "to": "OPENAI_BASE_URL"
+        },
+        {
+          "from": "LLM_MODEL",
+          "to": "NANOCLAW_MODEL"
+        }
+      ]
+    }
+  },
+  {
+    "name": "openclaw",
+    "label": "OpenClaw",
+    "description": "Open-source coding agent with multi-model support",
+    "homepage": "https://github.com/openagents/openclaw",
+    "tags": [
+      "coding",
+      "open-source"
+    ],
+    "builtin": true,
+    "install": {
+      "binary": "openclaw",
+      "requires": [
+        "nodejs>=22",
+        "git"
+      ],
+      "macos": "npm install -g openclaw@latest",
+      "linux": "npm install -g openclaw@latest",
+      "windows": "npm install -g openclaw@latest"
+    },
+    "adapter": {
+      "module": "openagents.adapters.openclaw",
+      "class": "OpenClawAdapter",
+      "options": {
+        "openclaw_host": "127.0.0.1",
+        "openclaw_port": 18789,
+        "openclaw_agent_id": "main"
+      }
+    },
+    "env_config": [
+      {
+        "name": "LLM_API_KEY",
+        "description": "API key",
+        "required": true,
+        "password": true
+      },
+      {
+        "name": "LLM_BASE_URL",
+        "description": "API base URL (OpenAI-compatible endpoint)",
+        "required": false,
+        "default": "https://api.openai.com/v1",
+        "placeholder": "https://api.openai.com/v1"
+      },
+      {
+        "name": "LLM_MODEL",
+        "description": "Model name",
+        "required": false,
+        "placeholder": "gpt-4o, claude-sonnet-4-20250514, deepseek-chat, etc."
+      }
+    ],
+    "resolve_env": {
+      "rules": [
+        {
+          "from": "LLM_API_KEY",
+          "to": "OPENAI_API_KEY",
+          "unless_base_url_contains": "anthropic"
+        },
+        {
+          "from": "LLM_API_KEY",
+          "to": "ANTHROPIC_API_KEY",
+          "if_base_url_contains": "anthropic"
+        },
+        {
+          "from": "LLM_BASE_URL",
+          "to": "OPENAI_BASE_URL"
+        },
+        {
+          "from": "LLM_MODEL",
+          "to": "OPENCLAW_MODEL"
+        }
+      ]
+    },
+    "check_ready": {
+      "env_vars": [
+        "ANTHROPIC_API_KEY",
+        "OPENAI_API_KEY"
+      ],
+      "saved_env_key": "LLM_API_KEY",
+      "not_ready_message": "Not configured — press e to configure"
+    }
+  },
+  {
+    "name": "opencode",
+    "label": "OpenCode",
+    "description": "Open-source terminal-native AI coding agent",
+    "homepage": "https://opencode.ai",
+    "tags": [
+      "coding",
+      "open-source",
+      "cli",
+      "terminal"
+    ],
+    "install": {
+      "binary": "opencode",
+      "requires": [
+        "nodejs"
+      ],
+      "macos": "npm install -g opencode-ai@latest",
+      "linux": "npm install -g opencode-ai@latest",
+      "windows": "npm install -g opencode-ai@latest"
+    }
+  },
+  {
+    "name": "swebench",
+    "label": "SWE-bench Agent",
+    "description": "Language model agent for software engineering tasks",
+    "homepage": "https://swe-agent.com",
+    "tags": [
+      "coding",
+      "benchmarks",
+      "research"
+    ],
+    "install": {
+      "binary": "sweagent",
+      "macos": "pip install sweagent",
+      "linux": "pip install sweagent",
+      "windows": "pip install sweagent"
+    }
+  }
+]