ur-agent 1.19.0 → 1.21.0

package/docs/AGENT_FEATURES.md

@@ -31,6 +31,9 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --decision "Use package scripts before ad hoc commands"
 ur context-pack compress
+ur acp serve --port 8123
+ur acp status --json
+ur exec "add tests for the parser" --concurrency 4 --json
 ur repo-edit index
 ur repo-edit preview rename oldName --to newName
 ur repo-edit apply rename oldName --to newName --check "bun test"
@@ -46,8 +49,32 @@ ur browser-qa validate
 ur browser-qa run home-page-smoke --dry-run
 ur --discover-ollama
 ur --ollama-host http://192.168.1.50:11434
+ur worktree list
+ur worktree clean --dry-run
 ```
 
+## v1.21.0 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| Agent skill runner | `src/services/agents/agentSkillRunner.ts` | Reusable wrapper around `startBackgroundTask({ worktree: true, pr: true })` that polls to completion and returns a PR-style summary. |
+| Worktree slash skills | `/debug-v2`, `/refactor`, `/paper-implementation`, `/benchmark`, `/security-review`, `/dockerize`, `/latex-paper` | Bundled slash skills that expand into prompts for isolated worktree work with clean commits and PR output. |
+| Agent templates | `ur agent-templates install` | Adds `debug-v2`, `refactor`, `paper-implementation`, `benchmark`, `security-review`, `dockerize`, and `latex-paper` reusable agent templates under `.ur/agents/`. |
+| Worktree command | `ur worktree list\|status\|clean` | Inspect and clean up UR agent worktrees created by `ur bg` or slash skills. |
+
+## v1.20.0 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| ACP server for IDE extensions | `ur acp serve\|stop\|status` | HTTP+JSON-RPC Agent Communication Protocol server that exposes tool listing, tool calls, task submission, and status for VS Code/Cursor/Zed-like editors. |
+| Non-interactive pool execution | `ur exec [prompts...]` | Run one or more prompts headlessly with optional concurrency, worktrees, output capture, and dry-run. |
+| GitHub tool | `GitHub` | PR/issue/repo operations via the `gh` CLI. |
+| API tool | `Api` | REST HTTP calls with JSON/text output. |
+| Browser tool | `Browser` | Headless browser automation (fetch/goto/click/type/evaluate/screenshot); interactive actions require `UR_BROWSER_TOOL=1`. |
+| Docker tool | `Docker` | Container and compose operations via the `docker` CLI. |
+| Test-runner tool | `TestRunner` | Auto-detect and run project tests. |
+| Database tool | `Database` | SQL queries against SQLite, Postgres, MySQL, and DuckDB. |
+
 ## v1.19.0 Additions
 
 | Addition | Surface | What it adds |

package/docs/AGENT_TRENDS.md

@@ -46,6 +46,8 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --decision "Use manifest commands first"
 ur context-pack compress
+ur acp serve --port 8123
+ur exec "add tests for the parser" --concurrency 4 --json
 ur ci-loop --command "bun test" --dry-run
 ur artifacts capture-diff
 ur artifacts capture-tests --command "bun test"
@@ -88,6 +90,8 @@ Inside an interactive session:
 | Self-healing CI | Covered | `ur ci-loop` runs a command, summarizes failures, invokes a fix agent, and re-runs with bounded retries; commits/pushes are self-review gated | Wire to `ur trigger` so a failed CI webhook auto-launches the loop |
 | Verifiable artifacts | Covered | `ur artifacts` records plans/diffs/test-runs with approve/reject/feedback under `.ur/artifacts/`; comments steer active background agents through stream-json inbox injection | Attach browser-QA screenshots and link artifacts to claim-ledger entries |
 | Native IDE review | Covered | `ur ide diff` writes `.ur/ide/diffs/` bundles and `extensions/vscode-ur-inline-diffs/` provides a VS Code tree/webview/comment surface | Add JetBrains packaging if demand appears |
+| ACP / IDE agent server | Covered | `ur acp serve|stop|status` exposes an HTTP+JSON-RPC agent server so VS Code/Cursor/Zed extensions can list tools, call tools, and submit tasks | Ship reference editor extensions |
+| External tool integration | Covered | Built-in `GitHub`, `Api`, `Browser`, `Docker`, `TestRunner`, and `Database` tools complement existing file-system, terminal, web, and MCP tools | Add richer output parsing and error recovery |
 
 ## v1.13.9 Direct CLI Surfaces
 

package/docs/AGENT_UPGRADE_1.20.0.md

@@ -0,0 +1,42 @@
+# UR Agent 1.20.0 Upgrade Notes
+
+UR 1.20.0 adds IDE integration and a richer tool surface for agent workflows.
+
+## What Changed
+
+- **ACP server** — `ur acp serve|stop|status` exposes an HTTP+JSON-RPC Agent
+  Communication Protocol server for VS Code/Cursor/Zed-like editors. It lists
+  tools, calls tools, sends tasks, and reports status. Existing A2A and MCP
+  support remains unchanged.
+- **`ur exec`** — run one or more prompts in non-interactive mode with optional
+  concurrency, worktrees, and output capture.
+- **New built-in tools** exposed through the agent loop, MCP server, and ACP
+  server:
+  - `GitHub` — PR/issue/repo operations via the `gh` CLI.
+  - `Api` — REST HTTP calls with JSON/text output and path extraction.
+  - `Browser` — headless browser automation (fetch/goto/click/type/evaluate/
+    screenshot); interactive actions require `UR_BROWSER_TOOL=1`.
+  - `Docker` — container and compose operations via the `docker` CLI.
+  - `TestRunner` — auto-detect and run project tests.
+  - `Database` — SQL queries against SQLite, Postgres, MySQL, and DuckDB.
+- File-system and terminal tools (`FileRead`, `FileEdit`, `FileWrite`, `Glob`,
+  `Grep`, `Bash`, `PowerShell`) remain built in and are now also reachable via
+  ACP/MCP.
+
+## New Commands
+
+```sh
+ur acp serve --host 127.0.0.1 --port 8123
+ur acp status --json
+ur exec "refactor the parser" --concurrency 2 --json
+ur exec --file prompts.jsonl --output-dir ./outputs
+```
+
+## Validate
+
+```sh
+ur acp status
+ur exec --dry-run "add tests"
+bun run typecheck
+bun test
+```

package/docs/AGENT_UPGRADE_1.21.0.md

@@ -0,0 +1,58 @@
+# Upgrading to UR Agent v1.21.0
+
+## What's new
+
+v1.21.0 adds a set of worktree-first agent skills and a command to manage the worktrees they create.
+
+- **Agent skill runner** — `src/services/agents/agentSkillRunner.ts` wraps
+  `startBackgroundTask({ worktree: true, pr: true })`, polls the background run to
+  completion, and returns a PR-style summary with branch, commits, PR URL, and
+  diff summary.
+- **New bundled slash skills** — each skill expands into a prompt that instructs
+  the model to work in an isolated git worktree and produce a clean branch,
+  commits, and PR:
+  - `/debug-v2` — reproduce, root-cause, and fix a bug with a regression test
+  - `/refactor` — safe, test-backed refactoring
+  - `/paper-implementation` — implement an algorithm or system from a paper/URL
+  - `/benchmark` — add or run benchmarks and commit results
+  - `/security-review` — audit code for security issues, fix low-risk items
+  - `/dockerize` — add Dockerfile, compose file, health checks, `.dockerignore`
+  - `/latex-paper` — generate or compile a LaTeX paper/report
+- **Matching agent templates** — `debug-v2`, `refactor`, `paper-implementation`,
+  `benchmark`, `security-review`, `dockerize`, and `latex-paper` are now part of
+  `AGENT_TEMPLATES`. Install them with `ur agent-templates install`.
+- **`ur worktree`** — `ur worktree list|status|clean` inspects and cleans up UR
+  agent worktrees.
+
+## Quick examples
+
+```sh
+# Run a bug-fix agent in an isolated worktree
+ur -p /debug-v2 "parser crashes on empty input"
+
+# Same through the CLI
+ur bg run "reproduce and fix parser crash on empty input" --worktree --pr
+
+# List active worktrees and clean up finished ones
+ur worktree list
+ur worktree clean --dry-run
+ur worktree clean
+
+# Install the new agent templates
+ur agent-templates install debug-v2 refactor benchmark security-review dockerize latex-paper paper-implementation
+```
+
+## For users of `/debug`
+
+The existing `/debug` skill still reads the session debug log. `/debug-v2` is a
+separate skill for bug-fix work in a worktree. You can keep using `/debug` for
+diagnosing the current session and use `/debug-v2` (or `ur bg run ... --worktree
+--pr`) when you want a branch + PR.
+
+## Upgrade steps
+
+1. Pull the release and run `bun install`.
+2. Run `bun run typecheck` and `bun test` to confirm the local state.
+3. Install agent templates if you want the new `.ur/agents/*.md` files:
+   `ur agent-templates install`.
+4. No settings or project file migration is required.

package/docs/USAGE.md

@@ -123,6 +123,8 @@ UR includes slash commands and CLI subcommands for common workflows:
 - `ur ci-loop ...` to run tests, repair failures, and rerun with a bounded loop
 - `ur artifacts ...` to capture reviewable diffs, test runs, notes, and feedback
 - `ur ide diff ...` to capture editor-readable inline diff bundles
+- `ur acp ...` to start/stop/status the Agent Communication Protocol server for IDE extensions
+- `ur exec ...` to run prompts in non-interactive mode with optional concurrency
 - `ur eval bench ...` to import local SWE-bench, Terminal-Bench, or Aider Polyglot exports
 - `ur doctor` to inspect CLI health
 - `ur update` or `ur upgrade` to check for updates
@@ -147,9 +149,13 @@ ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --constraint "Run command evidence before claiming success"
 ur context-pack compress
+ur acp serve --port 8123
+ur exec "add tests for the parser" --concurrency 4 --json
 ur ci-loop --command "bun test" --dry-run
 ur artifacts capture-diff
 ur bg run "fix the flaky parser test" --worktree --dry-run
+ur worktree list
+ur worktree clean --dry-run
 ur repo-edit index
 ur repo-edit plan rename oldName --to newName
 ur repo-edit preview rename oldName --to newName

package/documentation/app.js

@@ -13,15 +13,15 @@ const featureGroups = [
   },
   {
     title: 'Agent platform',
-    tags: ['spec', 'workflow', 'pattern', 'crew', 'goal'],
+    tags: ['spec', 'workflow', 'pattern', 'crew', 'goal', 'worktree'],
     text: 'Spec-driven development, durable workflows, collaboration patterns, parallel crews, long-horizon goals, live execution boards, and resumable checkpoint state.',
-    commands: ['ur spec', 'ur workflow', 'ur pattern', 'ur crew', 'ur goal'],
+    commands: ['ur spec', 'ur workflow', 'ur pattern', 'ur crew', 'ur goal', 'ur worktree'],
   },
   {
     title: 'Judging, escalation, and repair',
     tags: ['oracle', 'arena', 'CI', 'artifacts'],
     text: 'Capability-aware fast/oracle model routing, best-of-N agent judging, test-first execution loops, self-healing CI loops, and reviewable artifacts for diffs, test runs, plans, and feedback.',
-    commands: ['ur escalate', 'ur arena', 'ur test-first', 'ur ci-loop', 'ur artifacts'],
+    commands: ['ur escalate', 'ur arena', 'ur test-first', 'ur ci-loop', 'ur artifacts', 'ur bg'],
   },
   {
     title: 'Reliable repo editing',
@@ -76,6 +76,13 @@ const commands = [
     summary: 'Run one prompt headlessly and exit. This is the base mode for scripts, CI, evals, triggers, SDK calls, and A2A tasks.',
     examples: ['ur -p "Summarize this repository"', 'ur -p --output-format json "Review the current diff"', 'ur -p --json-schema \'{"type":"object"}\' "Return structured output"'],
   },
+  {
+    name: 'acp',
+    category: 'Interop',
+    aliases: [],
+    summary: 'Agent Communication Protocol server for IDE extensions: serve, stop, and status.',
+    examples: ['ur acp serve --port 8123', 'ur acp status --json', 'ur acp stop'],
+  },
   {
     name: 'a2a',
     category: 'Interop',
@@ -83,6 +90,20 @@ const commands = [
     summary: 'A2A interoperability utilities: Agent Card, local task server, and delegation tokens.',
     examples: ['ur a2a card', 'ur a2a serve --dry-run', 'ur a2a token mint --secret "$UR_A2A_DELEGATION_SECRET" --scope coding,review'],
   },
+  {
+    name: 'bg',
+    category: 'Agent Platform',
+    aliases: ['background-agent'],
+    summary: 'Run and manage detached local background agents with optional worktrees and PR creation.',
+    examples: ['ur bg run "fix the flaky parser test" --worktree', 'ur bg list --json', 'ur bg status <id> --json'],
+  },
+  {
+    name: 'worktree',
+    category: 'Agent Platform',
+    aliases: ['worktrees'],
+    summary: 'List, inspect, and clean up UR agent worktrees created by background runs.',
+    examples: ['ur worktree list', 'ur worktree status <id>', 'ur worktree clean --dry-run'],
+  },
   {
     name: 'agent-features',
     category: 'Agent Platform',
@@ -108,8 +129,8 @@ const commands = [
     name: 'agent-templates',
     category: 'Agent Platform',
     aliases: ['agent-template'],
-    summary: 'List or install reusable project agent templates such as reviewer, test-runner, security-auditor, and docs-researcher.',
-    examples: ['ur agent-templates list', 'ur agent-templates install reviewer test-runner', 'ur agent-templates install --force'],
+    summary: 'List or install reusable project agent templates such as reviewer, test-runner, security-auditor, debug-v2, refactor, paper-implementation, benchmark, security-review, dockerize, and latex-paper.',
+    examples: ['ur agent-templates list', 'ur agent-templates install reviewer test-runner', 'ur agent-templates install debug-v2 refactor --force'],
   },
   {
     name: 'agent-trends',
@@ -335,6 +356,13 @@ const commands = [
     summary: 'Set up a long-lived authentication token when that subscription surface is enabled.',
     examples: ['ur setup-token'],
   },
+  {
+    name: 'exec',
+    category: 'Automation',
+    aliases: [],
+    summary: 'Run one or more prompts in non-interactive mode with optional concurrency, worktrees, and output capture.',
+    examples: ['ur exec "add tests for the parser" --json', 'ur exec --file prompts.jsonl --concurrency 4 --output-dir ./outputs', 'ur exec "refactor auth" --worktree --dry-run'],
+  },
   {
     name: 'trigger',
     category: 'Automation',
@@ -376,9 +404,14 @@ const slashGroups = [
   },
   {
     title: 'Agents and orchestration',
-    items: ['/agents', '/agent-templates', '/spec', '/workflow', '/pattern', '/crew', '/goal', '/arena', '/route', '/role-mode'],
+    items: ['/agents', '/agent-templates', '/spec', '/workflow', '/pattern', '/crew', '/goal', '/arena', '/route', '/role-mode', '/bg'],
     text: 'Manage agents, install role modes, run specs and workflows, and coordinate multi-agent work.',
   },
+  {
+    title: 'Agent skills',
+    items: ['/debug-v2', '/refactor', '/paper-implementation', '/benchmark', '/security-review', '/dockerize', '/latex-paper', '/simplify', '/debug'],
+    text: 'Bundled slash skills that dispatch focused agent work in isolated git worktrees with clean commits and PR output.',
+  },
   {
     title: 'Memory and evidence',
     items: ['/memory', '/remember', '/forget', '/knowledge', '/semantic-memory', '/claim-ledger', '/evidence', '/graph'],

package/documentation/index.html

@@ -43,7 +43,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.19.0</p>
+          <p class="eyebrow">Version 1.21.0</p>
           <h1>UR Agent Documentation</h1>
           <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR Agent.</p>
         </div>
@@ -250,6 +250,19 @@ ur context-pack remember --decision "Use manifest commands first"
 ur context-pack compress</code></pre>
           </article>
 
+          <article>
+            <h3>Start the ACP server and run a prompt pool</h3>
+            <ol>
+              <li>Start the Agent Communication Protocol server for IDE extensions.</li>
+              <li>Run one or more prompts in non-interactive mode with concurrency.</li>
+              <li>Capture per-prompt outputs to a directory.</li>
+            </ol>
+            <pre><code>ur acp serve --port 8123
+ur acp status --json
+ur exec "add tests for the parser" --concurrency 4 --json
+ur exec --file prompts.jsonl --output-dir ./outputs --dry-run</code></pre>
+          </article>
+
           <article>
             <h3>Use a multi-agent pattern</h3>
             <ol>

package/extensions/vscode-ur-inline-diffs/package.json

@@ -2,7 +2,7 @@
   "name": "ur-inline-diffs",
   "displayName": "UR Inline Diffs",
   "description": "Review UR inline diff bundles from .ur/ide/diffs inside VS Code.",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "description": "UR terminal coding agent CLI",
   "type": "module",
   "packageManager": "bun@1.3.14",