Skip to content

docs: name the portable Windows asset and describe the second-instance message #1607

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mblua wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: name the portable Windows asset and describe the second-instance message #1607

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ agentscommander new-project /path/to/project

The npm package is `@mblua/agentscommander`. The installed command is still `agentscommander`.

Prefer a desktop installer or a manual download? Get the Windows installer, Linux AppImage, macOS dmg, or portable assets from [GitHub Releases](https://github.com/mblua/AgentsCommander/releases/latest).
Prefer a desktop installer or a manual download? Get the Windows installer, the Windows portable zip (`agentscommander-X.Y.Z-windows-x86_64-portable.zip`), the Linux AppImage, or the macOS dmg from [GitHub Releases](https://github.com/mblua/AgentsCommander/releases/latest).

## The 30-second pitch

Expand Down Expand Up @@ -88,7 +88,7 @@ You bring the coding agents. AgentsCommander coordinates them.
agentscommander
```

Prefer a desktop installer or portable binary? Use [GitHub Releases](https://github.com/mblua/AgentsCommander/releases/latest).
Prefer a desktop installer, or a portable copy you unzip and run? Use [GitHub Releases](https://github.com/mblua/AgentsCommander/releases/latest).
2. **Open a project**: click `New Project` in the sidebar and point it at an empty folder. AC creates a Project AC Root (`.ac/`) there.
3. **Create a Team**: add an orchestrator and one worker agent, each with a role prompt. [Teams and workgroups](docs/agents/teams-and-workgroups.md) walks through this.
4. **Launch the orchestrator**: pick Claude Code, Codex, Antigravity, Pi, or OpenCode from the dropdown. Ask it to send the worker a hello message. The worker terminal receives a file notification and responds in real time.
Expand Down
2 changes: 2 additions & 0 deletions docs/features/portable-instances.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,8 @@ Unknown suffixes get a deterministic port in the 9880–9899 range based on a ha

That's it. The instance creates its own config directory on first launch, gets a unique mutex (so it does not conflict with other instances), and shows **[MYTEAM]** in the titlebar.

The rename is what makes the copy independent, not the folder you put it in. Two copies that still share a file name share one instance identity, so starting the second one shows a message explaining the collision and pointing at the rename, then exits without disturbing the first. Before #1592 it exited silently, which looked like nothing happening at all.

## Why you might want this

- **Stage / prod parity.** Run `agentscommander_stage.exe` against your test repos while the canonical `agentscommander.exe` stays focused on shipping work.
Expand Down
4 changes: 2 additions & 2 deletions docs/quickstart.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ If you prefer a desktop installer or manual download, get the latest asset for y

| Platform | Asset |
|---|---|
| Windows 10 1809+ | `Agents Commander_X.Y.Z_x64-setup.exe` or the portable `agentscommander.exe` |
| Windows 10 1809+ | `Agents Commander_X.Y.Z_x64-setup.exe`, or `agentscommander-X.Y.Z-windows-x86_64-portable.zip` for a no-install copy |
| Linux | `agentscommander_*_amd64.AppImage` |
| macOS | `Agents Commander_*.dmg` (Apple Silicon + Intel) |

Expand All @@ -43,7 +43,7 @@ Windows code signing is planned through SignPath and pending setup. Current Wind
Get-AuthenticodeSignature "Agents Commander_X.Y.Z_x64-setup.exe"
```

Run the installer, or drop the portable `.exe` into any folder and double-click. On first launch AC creates its config directory next to the binary (e.g. `.agentscommander/` on Windows). See [Portable instances](features/portable-instances.md) for the rules.
Run the installer, or unzip the portable download into any folder and double-click `agentscommander.exe`. On first launch AC creates its config directory next to the binary (e.g. `.agentscommander/` on Windows). The zip also carries a `PORTABLE.txt` covering updates, second instances, and the WebView2 requirement. See [Portable instances](features/portable-instances.md) for the rules.

## 2. Open or create an AC project

Expand Down
7 changes: 4 additions & 3 deletions packaging/windows/PORTABLE.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,10 @@ RUNNING MORE THAN ONE INSTANCE
sessions, its own ports, and its own single-instance lock. The suffix shows
as a badge in the title bar.

Two copies with the SAME file name are the same instance identity even in
different folders, so the second one will not open a second window. Rename
it if you want both running at once.
Two copies with the SAME file name are the same instance identity, even in
different folders. Starting the second one shows a message saying so and
then closes it, leaving the first instance untouched. Rename it if you want
both running at once.


REQUIREMENTS
Expand Down
Loading