Skip to content

0.7.0 — accounts, project groups and destinations, and a fleet that survives restarts

Choose a tag to compare

@AnmolMajithia AnmolMajithia released this 26 Sep 00:57
53385d4

Accounts, project groups and destinations, and a fleet that survives restarts.

0.7.0 is a feature release. It gathers the whole usability backlog merged through #203: 21 pull requests and 18 issues. Everything in it went through independent review rounds, then a whole-release review whose findings were checked by adversarial verifiers, before it shipped. CI is green on Linux (Python 3.11–3.13), on both ambient legs, and on Windows.

The full list, with every detail, is in CHANGELOG.md → 0.7.0.

Install / upgrade

# fresh install: works out what your machine has, installs what's missing
curl -fsSL https://raw.githubusercontent.com/AISquare-Studio/aisquare-cli/main/install.sh | sh

# already installed with uv (the installer's default)
uv tool upgrade aisquare-cli          # or, if you pinned a version:
uv tool install --force aisquare-cli@0.7.0

aisquare --version    # aisquare 0.7.0
aisquare doctor

Highlights

Claude accounts (#145, #146, #152)

  • Add several Claude accounts and give them a default and a priority order.
  • Spawns go to the account with usage headroom.
  • A usage limit hands the agent over to another account, and the agent keeps its task claims.
  • The usage table shows the reset time and date for both the five-hour and weekly windows.

The fleet UI

  • A resizable navigator (#137). Drag the divider, or use < > =. The width is remembered.
  • Project groups, pins and a manual order (#140), by drag and drop or keys, with undo.
  • Captured is not shown (#139). Directories that hooks only touched stay out of the list until you onboard them. project list --all shows everything.
  • An agent's pane behaves like a terminal:
    • mouse buttons reach programs that track the mouse (#148)
    • select and copy (#120)
    • alt+letter chords (#117)
    • a bare modifier press is silent (#151)
    • a full hotkey audit (#147)
  • Windows are born the width they're shown at (#149), so Claude Code's diff panel fits.
  • The 🔔 rings only for a real prompt (#153).

Agents that survive

  • Restart is the same agent (#138, #144). The launch spec is recorded at spawn and replayed. Stop and Restart are on the agent view, and fleet restart resumes the session.
  • aisquare fleet shutdown (#121) is the fleet's off switch. Rows are no longer stuck at "unknown".
  • Safer hand-overs:
    • they are compare-and-set, so exactly one replacement starts
    • a failed replacement never releases claims it doesn't own
    • a row that outlived its tmux server never acts on another agent that reused its pane id
  • A spawned agent is told the task it was spawned for (#116).

Explainability

  • Pick where a project's traces land with your sign-in (#142): workspaces, studios, use. The key is minted for you, and a minted key is always revoked or kept on record until its revocation is confirmed.
  • A workspace key per project (#141). It is stored at mode 600 and bound to one deployment. A project's destination never falls back to another deployment's gateway, and one project's use never re-points another.
  • Workspace credits (#143) in status, whoami, the Accounts page and doctor --live.
  • The proxy lane is judged by where it actually ships (#131). Setup is a form on the Explainability tab.
  • Auto mode's classifier failure behind the proxy is named (#150): in doctor, at spawn and on refusal.

Store and platform

  • Schema v24. Every migration from v15 up is idempotent. A convergence pass repairs stores another build stamped, such as a v15 or v17 branch build.
  • doctor names what a store lacks instead of calling it "readable".
  • project forget --purge clears every table that references the project.
  • Windows (#65):
    • green CI
    • credentials written atomically under a lock, owner-only from creation, with the DACL read back to check it
    • icacls and whoami run by absolute path
  • Hermetic test suite (#79). The suite no longer reads the real ~/.claude account.

Upgrade notes

  • The first run of 0.7.0 migrates ~/.aisquare/context.db to schema v24. To keep a copy first:
    sqlite3 ~/.aisquare/context.db ".backup ~/.aisquare/context.db.pre-0.7.0"
  • aisquare init --reinit on a config.toml it cannot read now needs --yes. UTF-16 and BOM configs, such as those written by PowerShell 5.1, are read normally.
  • On tmux older than 3.5, shift+enter is sent as C-j. The installer recommends tmux 3.5 or newer.

Known issues

  • Explainability destinations and per-project keys are the newest area. Please report anything odd with aisquare doctor --live --json.
  • A missing project key file makes launches fall back to the machine key (the Explainability tab names the missing file). This is under review.
  • On slow Windows runners, a few wall-clock performance tests can exceed their budgets.

Full diff: v0.6.0...v0.7.0