Development

Development

git clone https://github.com/scortes5/agentboard.git
cd agentboard
npm install        # dependencies + node-pty permission fix
npm start          # run in development mode
npm run check      # which agent CLIs are installed
npm run app        # build and install the app
npm run dist:mac   # .dmg files      ·  npm run dist:win  → .exe
npm run icon       # regenerate icons from src/assets/logo.svg

Checks

CI (.github/workflows/ci.yml) runs on every push and pull request:

npm ci --ignore-scripts
git ls-files '*.js' | xargs -n1 node --check

CodeQL code scanning (GitHub default setup) analyzes JavaScript and workflows on every push and pull request. Dependabot opens weekly update PRs for npm packages and GitHub Actions.

Releasing

1. Bump version in package.json (and VERSION in scripts/agentboard-mcp.js).
2. Move Unreleased entries in CHANGELOG.md under the new version.
3. git tag vX.Y.Z && git push --tags.
4. The build workflow builds macOS and Windows installers and attaches them to the Release with generated notes.

Editing this wiki

Pages live in wiki/. The wiki workflow publishes them to the GitHub Wiki on every push to main. File names become page titles (Quick-Start.md → Quick Start); link between pages with [[Page Name]].

See also: CONTRIBUTING.md · Architecture