dispatch-agent-workspace

A CLI tool to help developers work on multiple features and AI agents in separate workspaces.

Install

npm install -g dispatch-agent-workspace

Commands

dispatch whereami

Prints the current working directory.

$ dispatch whereami
/Users/you/projects/my-feature

Updates

dispatch checks for new versions in the background after each run. When an update is available, you'll see a notice on your next command:

  Update available: 0.1.0 → 0.2.0
  Run: npm update -g dispatch-agent-workspace

To always run the latest version without a global install:

npx dispatch-agent-workspace@latest <command>

Development

Setup

# Clone and install
git clone https://github.com/<your-username>/dispatch
cd dispatch
pnpm install   # also sets up git hooks via husky

Local testing with npm link

# Link once from the project root:
npm link

# `dispatch` is now available globally, pointing live at dist/
# After code changes, rebuild:
pnpm build

# Unlink when done:
npm unlink -g dispatch-agent-workspace

Dev mode (no build step)

pnpm dev -- whereami

Build

pnpm build       # compile TypeScript → dist/
pnpm typecheck   # type-check without emitting

Commit conventions

This project uses Conventional Commits. The format is enforced by a git hook — non-conforming commit messages will be rejected.

<type>(<optional scope>): <description>

Types: feat | fix | docs | refactor | test | chore | perf | ci | build

Publishing a release

Releases are triggered manually in GitHub Actions:

1. Go to Actions → Publish → Run workflow
2. Select:
   • release_type: patch, minor, or major
   • prerelease: check for a beta release (dispatch-agent-workspace@next), leave unchecked for stable (dispatch-agent-workspace@latest)
3. Click Run workflow

The workflow will:

• Bump the version and update CHANGELOG.md
• Create a git tag and GitHub release
• Publish to npm with the correct dist-tag

Requires the NPM_TOKEN secret to be set in GitHub repository settings.

Dry run locally

pnpm release -- --dry-run