acdev 1.0.5 → 1.0.6

package/.acdev/.env.example

@@ -13,6 +13,9 @@
 # An API key takes precedence over subscription login:
 # ANTHROPIC_API_KEY=sk-ant-your-key-here
 #
+# OpenRouter (only when llmProvider is "openrouter" in Settings / config.json):
+# OPENROUTER_API_KEY=sk-or-your-openrouter-key
+#
 # Jira Cloud (only when ticketSource is "jira" in Settings / config.json):
 # JIRA_BASE_URL=https://your-domain.atlassian.net
 # JIRA_EMAIL=you@company.com

package/README.md

@@ -15,9 +15,9 @@ You do **not** need GitHub or Claude tokens before starting `acdev`. The server
 ## Install
 
 ```bash
-npm i -g @giangarcia14/acdev
+npm i -g acdev
 # or
-npx @giangarcia14/acdev
+npx acdev
 ```
 
 From a local clone (development):
@@ -29,9 +29,9 @@ npm link   # optional — makes `acdev` available globally
 
 ## Authentication
 
-`acdev` starts even when auth is missing and prints a warning. Configure GitHub and Claude from **Settings → Authentication** in the web UI (tokens are written to `.acdev/.env`, gitignored) or by editing that file directly. Leave a Settings field blank to keep the current secret. Shell environment variables override `.env` on startup; saving in Settings updates the running process immediately so status refreshes without a restart.
+`acdev` starts even when auth is missing and prints a warning. Configure GitHub and your LLM provider (Claude or OpenRouter) from **Settings → Authentication** in the web UI (tokens are written to `.acdev/.env`, gitignored) or by editing that file directly. Leave a Settings field blank to keep the current secret. Shell environment variables override `.env` on startup; saving in Settings updates the running process immediately so status refreshes without a restart.
 
-Enqueueing issues, retrying jobs, and applying review feedback require Claude (unless `--stub-agent`). Opening a PR always requires GitHub auth. The Overview banner prompts you when auth is incomplete.
+Enqueueing issues, retrying jobs, and applying review feedback require the configured LLM provider to be authenticated (Claude or OpenRouter, unless `--stub-agent`). Opening a PR always requires GitHub auth. The Overview banner prompts you when auth is incomplete.
 
 `.env` is optional when you already use `gh auth login` and `claude auth login` on the machine.
 
@@ -92,6 +92,12 @@ acdev
 
 A Claude.ai browser-only subscription does **not** give you an API key. API keys come from the [Claude Console](https://platform.claude.com/) and are billed separately from Pro/Max. To switch back to subscription login, clear the saved API key in Settings (or omit it from `.env`).
 
+### OpenRouter (optional LLM provider)
+
+In **Settings → Configuration**, set **LLM provider** to **OpenRouter**, then add your API key under **Settings → Authentication → OpenRouter authentication** (or set `OPENROUTER_API_KEY` in `.acdev/.env`). Agent runs still use the Claude Agent SDK, routed through OpenRouter’s Anthropic-compatible API (`ANTHROPIC_BASE_URL=https://openrouter.ai/api`). Choose any model from the OpenRouter dropdown (e.g. `anthropic/claude-sonnet-4`).
+
+**Note:** OpenRouter works best with Anthropic models on OpenRouter. Some SDK versions send Anthropic-only beta headers that OpenRouter may reject; if agent runs fail with a `context-management` error, use Claude provider directly or an Anthropic model slug on OpenRouter.
+
 ## Jira ticket source
 
 Tickets can come from **GitHub Issues** or **Jira Cloud**. Switch in **Settings → Ticket source**. The server still requires `gh` auth (PRs); Jira credentials are only required when enqueueing Jira issues.
@@ -211,14 +217,19 @@ On first run, creates `.acdev/config.json`:
 | `close_issue` | Transitions to a Done-category status, or else a Done/Closed/Resolved-like name | Closes the GitHub issue |
 
 Legacy Jira configs that only had `enabled` + `targetStatus` (no `action`) still work: when enabled, they migrate to `action: "set_status"`.
-Supported `model` values are Claude Agent SDK / Claude Code model ids (aliases like `claude-sonnet-5` / `claude-opus-5` / `sonnet`, or Anthropic API model ids). The Settings dropdown is populated by `GET /api/models`:
+Supported `model` values depend on the selected LLM provider (`llmProvider` in config):
+
+- **Claude** (`llmProvider: "claude"`, default) — Claude Agent SDK / Claude Code model ids (aliases like `claude-sonnet-5` / `claude-opus-5` / `sonnet`, or Anthropic API model ids).
+- **OpenRouter** (`llmProvider: "openrouter"`) — OpenRouter model slugs (e.g. `anthropic/claude-sonnet-4`, `openai/gpt-4o`).
+
+The Settings model dropdown is populated by `GET /api/models?provider=claude|openrouter`:
 
-1. When `ANTHROPIC_API_KEY` (or `ANTHROPIC_AUTH_TOKEN` / `CLAUDE_CODE_OAUTH_TOKEN`) is set — or Claude Code browser login credentials are readable from the local store — acdev calls Anthropic’s Models API (`GET /v1/models`) and merges results with curated Claude Code aliases.
-2. Otherwise (or if the live fetch fails), the UI falls back to a curated list (Sonnet/Opus/Fable/Haiku generations + common Code aliases such as `sonnet` / `opus`) so the dropdown stays useful without an API key. The Settings hint notes when the list is static (`source: "fallback"`).
+1. **Claude** — When `ANTHROPIC_API_KEY` (or `ANTHROPIC_AUTH_TOKEN` / `CLAUDE_CODE_OAUTH_TOKEN`) is set — or Claude Code browser login credentials are readable — acdev calls Anthropic’s Models API and merges results with curated Claude Code aliases. Otherwise falls back to a curated list (`source: "fallback"`).
+2. **OpenRouter** — When `OPENROUTER_API_KEY` is set, acdev calls `GET https://openrouter.ai/api/v1/models` and merges with curated OpenRouter defaults. Without a key, shows curated OpenRouter models only.
 
-Empty or malformed model IDs in an existing config are migrated to `claude-sonnet-5` on load. Other valid ids are kept as-is.
+Empty or malformed model IDs in an existing config are migrated to the provider default on load (`claude-sonnet-5` or `anthropic/claude-sonnet-4`). Switching providers in Settings resets the model when the current id is not in the new provider’s curated list.
 
-Change via **Settings → Configuration** (`PATCH /api/config`) or `--model`. Takes effect for the next agent run without restart.
+Change provider/model via **Settings → Configuration** (`PATCH /api/config`) or `--model`. Takes effect for the next agent run without restart.
 
 Job state is persisted in `.acdev/state.json`.
 
@@ -234,11 +245,12 @@ npm test
 
 - `bin/acdev.js` — CLI entry; soft-checks `gh` / Claude auth (warns, does not exit). Tokens in `.acdev/.env` are loaded before auth checks. Job APIs reject until auth is OK.
 - `src/claude-auth.js` — Anthropic API key / Claude Code subscription auth detection
+- `src/openrouter-auth.js` — OpenRouter API key detection
 - `src/gh-auth.js` — GitHub CLI auth (`gh auth login` or `GH_TOKEN`)
 - `src/server.js` — Express API, SSE logs, job queue, config + Jira test endpoints
 - `src/git.js` — Worktree lifecycle (`issue-<id>` paths), `feat/`/`fix/` branch naming, diff, push
-- `src/agent.js` — Claude Agent SDK integration (`options.model`); GitHub vs Jira prompts
-- `src/models.js` — `GET /api/models` list (Anthropic Models API + curated fallback)
+- `src/agent.js` — Claude Agent SDK integration; OpenRouter via Anthropic-compatible routing when `llmProvider` is `openrouter`
+- `src/models.js` — `GET /api/models` list (Anthropic or OpenRouter APIs + curated fallback)
 - `src/github.js` — Issue URL parsing, issue fetch via `gh`, `createPr({ draft })`
 - `src/jira.js` — Jira Cloud parse/fetch/test + issuetype → feat/fix
 - `src/config.js` — Load/save `.acdev/config.json` including ticket source
@@ -259,8 +271,8 @@ npm test
 | `DELETE` | `/api/jobs/:id` | Clear job from history (worktree best-effort); 409 if in-flight |
 | `POST` | `/api/jobs/:id/retry` | Re-queue failed/discarded |
 | `GET` | `/api/config` | Editable config + curated models + Jira status (token masked) |
-| `GET` | `/api/models` | `{ models, selected, source }` — live Anthropic list or curated fallback |
-| `PATCH` | `/api/config` | Partial update including `ticketSource`, `jiraBaseUrl`; `jiraEmail` / `jiraApiToken` → `.env` |
+| `GET` | `/api/models` | `{ models, selected, source, provider }` — live provider list or curated fallback (`?provider=claude\|openrouter`) |
+| `PATCH` | `/api/config` | Partial update including `llmProvider`, `ticketSource`, `jiraBaseUrl`; secrets (`openrouterApiKey`, `jiraEmail`, etc.) → `.env` |
 | `POST` | `/api/jira/test` | Test Jira credentials (`GET /rest/api/3/myself`) |
 
 ### Branch naming

package/bin/acdev.js

@@ -4,6 +4,8 @@ import { execSync } from 'node:child_process';
 import http from 'node:http';
 import open from 'open';
 import { checkClaudeAuth, formatClaudeAuthError } from '../src/claude-auth.js';
+import { checkOpenRouterAuth, formatOpenRouterAuthError } from '../src/openrouter-auth.js';
+import { isValidLlmProvider } from '../src/models.js';
 import { checkGhAuth, formatGhAuthError } from '../src/gh-auth.js';
 import { loadConfig } from '../src/config.js';
 import { loadEnv } from '../src/env.js';
@@ -58,7 +60,7 @@ async function main() {
   migrateLegacyWorktreesDir(repoRoot);
   loadEnv(repoRoot);
 
-  // Soft auth: never exit for missing GitHub/Claude credentials.
+  // Soft auth: never exit for missing GitHub/LLM credentials.
   // Always start the server so Settings can add tokens; job endpoints
   // reject with a clear 4xx until auth is configured.
   const ghAuth = checkGhAuth();
@@ -66,15 +68,6 @@ async function main() {
     console.warn(formatGhAuthError(ghAuth));
   }
 
-  if (!opts.stubAgent) {
-    const claudeAuth = checkClaudeAuth();
-    if (!claudeAuth.ok) {
-      console.warn(formatClaudeAuthError(claudeAuth));
-    }
-  } else {
-    console.log('✓ Stub agent enabled (Claude auth not required)');
-  }
-
   const config = loadConfig(repoRoot);
   if (opts.baseBranch) {
     config.baseBranch = opts.baseBranch;
@@ -83,6 +76,23 @@ async function main() {
     config.model = opts.model;
   }
 
+  if (!opts.stubAgent) {
+    const provider = isValidLlmProvider(config.llmProvider) ? config.llmProvider : 'claude';
+    if (provider === 'openrouter') {
+      const openrouterAuth = checkOpenRouterAuth();
+      if (!openrouterAuth.ok) {
+        console.warn(formatOpenRouterAuthError(openrouterAuth));
+      }
+    } else {
+      const claudeAuth = checkClaudeAuth();
+      if (!claudeAuth.ok) {
+        console.warn(formatClaudeAuthError(claudeAuth));
+      }
+    }
+  } else {
+    console.log('✓ Stub agent enabled (LLM auth not required)');
+  }
+
   const store = new Store(repoRoot);
   store.reconcileStaleJobs();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acdev",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Local CLI + web UI for running AI agents on GitHub issues via git worktrees",
   "type": "module",
   "bin": {