iliya 273a4b68a9 docs: update RELEASE.md with v1.2.0 entry

2026-03-31 12:00:53 +03:00

11 KiB

Raw Blame History

Release Guide

Published: v1.2.0 (2026-03-31)

Agent Graph, per-team tool approval, interactive AskUserQuestion, task comment notifications, cross-team ghost nodes. Major graph improvements: force-directed visualization with kanban task layout, fullscreen/tab mode, animated particles, member hexagons with avatars, popover actions. Permission system overhaul with proper Write/Edit/NotebookEdit seeding and MCP tool catalog integration. Full list: CHANGELOG.md.

Published: v1.1.0 (2026-03-26)

Minor release: React 19 + Electron 40 migration, start-task-by-user, auth troubleshooting guide, syntax highlighting for R/Ruby/PHP/SQL, search performance improvements, cost tracking accuracy, WSL/Windows path fixes. Full list: CHANGELOG.md.

Published: v1.0.0 (2026-03-19)

Initial release: Claude Agent Teams UI with reliable CLI detection in packaged builds (shell PATH/HOME, CLAUDE_CONFIG_DIR, auth output parsing), IPC status cache handling, concurrent binary resolution, capped NDJSON diagnostics. Full list: CHANGELOG.md.

After CI uploads artifacts, optional notes update:

gh release edit v1.0.0 --repo 777genius/claude_agent_teams_ui --notes "$(cat <<'EOF'
## Claude Agent Teams UI v1.0.0

First stable build: CLI/auth reliability in packaged apps, IPC hardening, and platform packaging.

### What's New
- Setting to auto-expand AI response groups in transcripts (`general.autoExpandAIGroups`).

### Improvements
- CLI status uses interactive shell environment and merged PATH so packaged builds match terminal behavior.
- Stricter IPC validation and clearer notification/update contracts.

### Bug Fixes
- Fix false "not logged in" when the CLI is authenticated in the shell.
- Clear stale CLI status cache when status refresh fails.
- Windows path edge cases in tooling and tests.

### Downloads

<table>
<tr>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/Claude.Agent.Teams.UI-1.0.0-arm64.dmg">
    <img src="https://img.shields.io/badge/macOS_Apple_Silicon-.dmg-000000?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Apple Silicon" />
  </a>
  <br />
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/Claude.Agent.Teams.UI-1.0.0.dmg">
    <img src="https://img.shields.io/badge/macOS_Intel-.dmg-434343?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Intel" />
  </a>
</td>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/Claude.Agent.Teams.UI.Setup.1.0.0.exe">
    <img src="https://img.shields.io/badge/Windows-Download_.exe-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Windows" />
  </a>
  <br />
  <sub>May trigger SmartScreen — click "More info" → "Run anyway"</sub>
</td>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/Claude.Agent.Teams.UI-1.0.0.AppImage">
    <img src="https://img.shields.io/badge/Linux-Download_.AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux AppImage" />
  </a>
  <br />
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/claude-agent-teams-ui_1.0.0_amd64.deb">
    <img src="https://img.shields.io/badge/.deb-E95420?style=flat-square&logo=ubuntu&logoColor=white" alt=".deb" />
  </a>&nbsp;
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/claude-agent-teams-ui-1.0.0.x86_64.rpm">
    <img src="https://img.shields.io/badge/.rpm-294172?style=flat-square&logo=redhat&logoColor=white" alt=".rpm" />
  </a>&nbsp;
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v1.0.0/claude-agent-teams-ui-1.0.0.pacman">
    <img src="https://img.shields.io/badge/.pacman-1793D1?style=flat-square&logo=archlinux&logoColor=white" alt=".pacman" />
  </a>
</td>
</tr>
</table>
EOF
)"

Versioning (SemVer)

Format: MAJOR.MINOR.PATCH

Bump	When	Example
MAJOR	Breaking changes, major UI overhaul, incompatible data format changes	1.0.0 → 2.0.0
MINOR	New features, new panels/views, new integrations	1.0.0 → 1.1.0
PATCH	Bug fixes, performance improvements, small UI tweaks	1.0.0 → 1.0.1

Release Process

1. Prepare

# Make sure branch is clean and pushed
git status
git push origin <branch>

2. Create tag and push

git tag v<VERSION>
git push origin v<VERSION>

This triggers the release.yml GitHub Actions workflow which:

Builds the app (ubuntu)
Packages macOS arm64 + x64 (with code signing & notarization)
Packages Windows (NSIS installer)
Packages Linux (AppImage, deb, rpm, pacman)
Creates a GitHub Release with all artifacts

3. Update release notes

After the workflow completes, edit the release notes:

gh release edit v<VERSION> --repo 777genius/claude_agent_teams_ui --notes "$(cat <<'EOF'
<paste release notes here>
EOF
)"

Release Notes Template

## Claude Agent Teams UI v<VERSION>

<1-2 sentence summary of the release>

### What's New
- feat: <feature description>
- feat: <feature description>

### Improvements
- improve: <improvement description>

### Bug Fixes
- fix: <bug fix description>

### Downloads

<table>
<tr>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/Claude.Agent.Teams.UI-<VERSION>-arm64.dmg">
    <img src="https://img.shields.io/badge/macOS_Apple_Silicon-.dmg-000000?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Apple Silicon" />
  </a>
  <br />
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/Claude.Agent.Teams.UI-<VERSION>.dmg">
    <img src="https://img.shields.io/badge/macOS_Intel-.dmg-434343?style=for-the-badge&logo=apple&logoColor=white" alt="macOS Intel" />
  </a>
</td>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/Claude.Agent.Teams.UI.Setup.<VERSION>.exe">
    <img src="https://img.shields.io/badge/Windows-Download_.exe-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Windows" />
  </a>
  <br />
  <sub>May trigger SmartScreen — click "More info" → "Run anyway"</sub>
</td>
<td align="center">
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/Claude.Agent.Teams.UI-<VERSION>.AppImage">
    <img src="https://img.shields.io/badge/Linux-Download_.AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux AppImage" />
  </a>
  <br />
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/claude-agent-teams-ui_<VERSION>_amd64.deb">
    <img src="https://img.shields.io/badge/.deb-E95420?style=flat-square&logo=ubuntu&logoColor=white" alt=".deb" />
  </a>&nbsp;
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/claude-agent-teams-ui-<VERSION>.x86_64.rpm">
    <img src="https://img.shields.io/badge/.rpm-294172?style=flat-square&logo=redhat&logoColor=white" alt=".rpm" />
  </a>&nbsp;
  <a href="https://github.com/777genius/claude_agent_teams_ui/releases/download/v<VERSION>/claude-agent-teams-ui-<VERSION>.pacman">
    <img src="https://img.shields.io/badge/.pacman-1793D1?style=flat-square&logo=archlinux&logoColor=white" alt=".pacman" />
  </a>
</td>
</tr>
</table>

Changelog Guidelines

Write changelog entries from the user's perspective, not the developer's.

Good:

"Add team member activity timeline with live status tracking"
"Fix crash when opening sessions with corrupted JSONL data"
"Improve session list loading speed by 3x with streaming parser"

Bad:

"Refactor ChunkBuilder to use new pipeline"
"Update dependencies"
"Fix bug in useEffect cleanup"

Group entries by type: What's New > Improvements > Bug Fixes > Breaking Changes (if any).

File Naming Convention

electron-builder generates these artifacts per platform:

Platform	Versioned Name	Stable Name (for /latest/download)
macOS arm64 DMG	`Claude.Agent.Teams.UI-<VER>-arm64.dmg`	`Claude-Agent-Teams-UI-arm64.dmg`
macOS x64 DMG	`Claude.Agent.Teams.UI-<VER>.dmg`	`Claude-Agent-Teams-UI-x64.dmg`
macOS arm64 ZIP	`Claude.Agent.Teams.UI-<VER>-arm64-mac.zip`	—
macOS x64 ZIP	`Claude.Agent.Teams.UI-<VER>-mac.zip`	—
Windows	`Claude.Agent.Teams.UI.Setup.<VER>.exe`	`Claude-Agent-Teams-UI-Setup.exe`
Linux AppImage	`Claude.Agent.Teams.UI-<VER>.AppImage`	`Claude-Agent-Teams-UI.AppImage`
Linux deb	`claude-agent-teams-ui_<VER>_amd64.deb`	`Claude-Agent-Teams-UI-amd64.deb`
Linux rpm	`claude-agent-teams-ui-<VER>.x86_64.rpm`	`Claude-Agent-Teams-UI-x86_64.rpm`
Linux pacman	`claude-agent-teams-ui-<VER>.pacman`	`Claude-Agent-Teams-UI.pacman`

Stable Download Links

The upload-stable-links job in release.yml re-uploads key assets with version-agnostic names. It starts only after release-mac (two matrix jobs), release-win, and release-linux all succeed, so it often stays in Queued until the slowest job finishes. Delays of several minutes are common when macOS hosted runners are backed up.

This enables permanent links in README that always point to the latest release:

https://github.com/777genius/claude_agent_teams_ui/releases/latest/download/Claude-Agent-Teams-UI-arm64.dmg

GitHub automatically redirects /releases/latest/download/FILENAME to the asset from the most recent release. No README updates needed when releasing a new version.

macOS Code Signing

macOS builds are signed and notarized via GitHub Actions secrets:

Secret	Description
`CSC_LINK`	Base64-encoded .p12 certificate
`CSC_KEY_PASSWORD`	Certificate password
`APPLE_ID`	Apple Developer account email
`APPLE_APP_SPECIFIC_PASSWORD`	App-specific password from appleid.apple.com
`APPLE_TEAM_ID`	Apple Developer Team ID

Without these secrets, macOS builds will be unsigned (users need to bypass Gatekeeper manually).

Auto-Update

electron-builder generates latest-mac.yml, latest.yml, latest-linux.yml alongside release artifacts. These files enable the built-in auto-updater — users get notified when a new version is available.

Quick Reference

# Create and publish a release
git tag v1.0.0
git push origin v1.0.0
# Wait for CI to finish (~10 min), then update notes

# Delete a release (if needed)
gh release delete v1.0.0 --repo 777genius/claude_agent_teams_ui --yes
git tag -d v1.0.0
git push origin :refs/tags/v1.0.0

# Check workflow status
gh run list --repo 777genius/claude_agent_teams_ui --workflow release.yml --limit 3

11 KiB Raw Blame History