ci: add dev prerelease release line

Publish prereleases from the existing dev branch while keeping main on
latest. Document the dev channel install path and the merge-to-promote
workflow so future changes use the branch correctly.

Author: connorads

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [main]
+    branches: [main, dev]
   pull_request:
-    branches: [main]
+    branches: [main, dev]
 
 jobs:
   check:
@@ -27,7 +27,7 @@ jobs:
       - run: pnpm exec tsc --noEmit
 
   release:
-    if: github.ref == 'refs/heads/main'
+    if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev'
     needs: check
     runs-on: ubuntu-latest
     permissions:

.releaserc.json

@@ -1,5 +1,12 @@
 {
-	"branches": ["main"],
+	"branches": [
+		"main",
+		{
+			"name": "dev",
+			"channel": "dev",
+			"prerelease": "dev"
+		}
+	],
 	"plugins": [
 		"@semantic-release/commit-analyzer",
 		"@semantic-release/release-notes-generator",

AGENTS.md

@@ -106,9 +106,12 @@ Commits must follow [Conventional Commits](https://www.conventionalcommits.org/)
 - Transpiles to JS via tsdown: `bin` → `dist/cli.mjs`, `exports` → `dist/*.mjs` + `dist/*.d.mts`
 - `files` array controls what's published: `dist/`, `styles/`, `src/pwa/icons/`, `README.md`, `CHANGELOG.md`, `LICENSE`
 - CI: `.github/workflows/ci.yml` — pnpm test + biome check
-- Release: `release` job in `.github/workflows/ci.yml` — semantic-release on push to main, gated on `check` job
+- Release: `release` job in `.github/workflows/ci.yml` — semantic-release on push to `main` and `dev`, gated on `check` job
   - Versioning, changelog, npm publish, and GitHub Release are all automated
   - `npx semantic-release --dry-run` for local verification
+  - Stable channel: `main` → npm `latest`
+  - Prerelease channel: `dev` → npm `dev` + GitHub prereleases
+  - Promote experimental releases by merging `dev` into `main`
   - Release triggers: `feat:` → minor, `fix:` → patch, `BREAKING CHANGE` → major
   - No release: `chore:`, `docs:`, `refactor:`, `test:`, `ci:`
 - See **Local Development** above for running from source

README.md

@@ -18,7 +18,9 @@ It's a terminal on a 6-inch screen. It won't win design awards. But you can do *
 /bin/bash -c "$(curl -fsSL http://remobi.app/install.sh)"
 ```
 
-To upgrade: `npm install -g remobi@latest`
+To upgrade stable: `npm install -g remobi@latest`
+
+To try the experimental channel: `npm install -g remobi@dev`
 
 Your coding agent handles the rest. It installs remobi, inspects your tmux config, generates a config, and suggests tweaks to make your tmux more mobile-friendly — one conversation. Works with Claude Code and Codex.
 
@@ -54,6 +56,14 @@ For local development, see the [Development](#development) section below.
 
 Open `http://localhost:7681` on the same machine to verify it works. For phone access, put a trusted proxy/tunnel in front of it, for example [Tailscale Serve](docs/guides/tailscale-serve.md).
 
+## Release channels
+
+- `main` publishes stable releases to npm `latest`
+- `dev` publishes prereleases to npm `dev`
+- merge `dev` into `main` to promote an experimental line to stable
+
+If an experimental change is breaking for consumers, mark it with `feat!:` or `BREAKING CHANGE:` so semantic-release computes the right next version on both channels.
+
 ## Set up with AI
 
 Install the remobi skill: