rogerchappel/agentlane

agentlane

agentlane is a local-first TypeScript CLI for carving a repository into safe parallel work lanes for AI coding agents.

It reads the repo on disk, optionally folds in AGENTS.md, and emits deterministic Markdown or JSON lane plans with:

• branch names
• allowed paths
• stop-before-touching paths
• verification commands
• acceptance criteria

No hidden network calls. No shell-outs. No telemetry. Just a conservative lane plan you can hand to humans or agents.

Why this exists

Parallel agents only help when they stop stepping on each other. agentlane plan gives each worker a clear blast radius before code starts moving.

Install

The agentlane package is not published to npm yet. Install the verified tarball attached to the current GitHub release instead:

npm install https://github.com/rogerchappel/agentlane/releases/download/v0.1.0/agentlane-0.1.0.tgz

This installs the agentlane executable into nodemodules/.bin. The maintained publication state and release tarball URL live in docs/publication-state.json; the registry command will return here only after that metadata records a completed npm publication.

For local development in this repo:

npm install
npm run build

Quickstart

agentlane plan .
agentlane plan . --json
agentlane plan ../some-repo --agents ./AGENTS.md

CLI

agentlane plan [path] [--json] [--format markdown|json] [--agents ./AGENTS.md] [--no-core]

Pass at most one repository path; when omitted, agentlane uses the current directory. --agents must name a readable regular file and cannot be followed by another option. Relative --agents paths resolve from the repository root. A missing, unreadable, or non-file explicit path exits nonzero and names the invalid path; the default AGENTS.md remains optional when --agents is omitted.