cursorfleet 0.1.0__tar.gz → 0.1.1__tar.gz

cursorfleet-0.1.1/.github/workflows/container.yml

@@ -0,0 +1,50 @@
+name: Container (GHCR)
+
+# PyPI wheels do not appear under github.com/.../packages; this workflow publishes
+# ghcr.io/<owner>/cursorfleet so the repo shows a linked container package.
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "cursorfleet PyPI version (e.g. 0.1.0)"
+        required: true
+        default: "0.1.0"
+      tag:
+        description: "Extra GHCR tag (defaults to version; use latest to also tag latest)"
+        required: false
+        default: ""
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  publish:
+    name: publish ghcr.io image
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Resolve image tags
+        id: meta
+        run: |
+          version="${{ inputs.version }}"
+          extra="${{ inputs.tag }}"
+          tags="ghcr.io/${GITHUB_REPOSITORY,,}:${version}"
+          if [ "${extra}" = "latest" ] || [ "${version}" = "0.1.0" ]; then
+            tags="${tags},ghcr.io/${GITHUB_REPOSITORY,,}:latest"
+          elif [ -n "${extra}" ]; then
+            tags="${tags},ghcr.io/${GITHUB_REPOSITORY,,}:${extra}"
+          fi
+          echo "tags=${tags}" >> "$GITHUB_OUTPUT"
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          build-args: CURSORFLEET_VERSION=${{ inputs.version }}

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/.github/workflows/release.yml

@@ -104,3 +104,32 @@ jobs:
           name: dist
           path: dist/
       - uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-container:
+    name: publish container (GHCR)
+    runs-on: ubuntu-latest
+    needs: publish-pypi
+    if: vars.RELEASE_ENABLED == 'true'
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Package version from tag
+        id: ver
+        run: |
+          echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+          echo "image=ghcr.io/${GITHUB_REPOSITORY,,}" >> "$GITHUB_OUTPUT"
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ steps.ver.outputs.image }}:${{ steps.ver.outputs.version }}
+            ${{ steps.ver.outputs.image }}:latest
+          build-args: CURSORFLEET_VERSION=${{ steps.ver.outputs.version }}

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/CHANGELOG.md

@@ -8,7 +8,21 @@ CursorFleet is an unofficial tool: it is not affiliated with or endorsed by Anys
 
 ## [Unreleased]
 
-Development version `0.1.1.dev0` (post-v0.1.0). Planned: TUI attach picker, external alpha metrics.
+Development on `main` after v0.1.1. Planned: external alpha metrics, evidence closure.
+
+## [0.1.1] - 2026-10-13
+
+PyPI/README refresh and small UX fixes after the v0.1.0 launch.
+
+### Added
+
+- TUI: attach suggested sessions from Active run (Enter).
+- Optional `ghcr.io/m9nx/cursorfleet` container for GitHub Packages visibility.
+
+### Changed
+
+- README and [docs site](https://m9nx.github.io/cursorfleet/) document PyPI install and v0.1.0 release status.
+- PyPI `project.urls` Homepage/Documentation point at GitHub Pages.
 
 ## [0.1.0] - 2026-10-12
 

cursorfleet-0.1.1/Dockerfile

@@ -0,0 +1,11 @@
+# Optional runtime image for GitHub Container Registry (ghcr.io).
+# Primary install path remains PyPI: pip install cursorfleet
+FROM python:3.12-slim-bookworm
+
+ARG CURSORFLEET_VERSION
+RUN test -n "${CURSORFLEET_VERSION}" || (echo "CURSORFLEET_VERSION build-arg required" >&2 && exit 1)
+
+RUN pip install --no-cache-dir "cursorfleet==${CURSORFLEET_VERSION}"
+
+ENTRYPOINT ["cursorfleet"]
+CMD ["--help"]

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.5
 Name: cursorfleet
-Version: 0.1.0
+Version: 0.1.1
 Summary: Unofficial local TUI and workflow harness (observe-only) for Cursor agent teams.
-Project-URL: Homepage, https://github.com/M9nx/cursorfleet
-Project-URL: Documentation, https://github.com/M9nx/cursorfleet/tree/main/docs
+Project-URL: Homepage, https://m9nx.github.io/cursorfleet/
+Project-URL: Documentation, https://m9nx.github.io/cursorfleet/
 Project-URL: Source, https://github.com/M9nx/cursorfleet
 Project-URL: Issues, https://github.com/M9nx/cursorfleet/issues
 Project-URL: Changelog, https://github.com/M9nx/cursorfleet/blob/main/CHANGELOG.md
 Project-URL: Security, https://github.com/M9nx/cursorfleet/blob/main/SECURITY.md
+Project-URL: Release notes, https://github.com/M9nx/cursorfleet/releases/tag/v0.1.1
 Author: M9nx
 License-Expression: MIT
 License-File: LICENSE
@@ -50,13 +51,16 @@ Description-Content-Type: text/markdown
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
   <img src="https://img.shields.io/badge/status-pre--alpha-orange.svg" alt="Status: pre-alpha" />
   <img src="https://img.shields.io/badge/python-3.11%2B-blue.svg" alt="Python 3.11+" />
-  <a href="https://m9nx.github.io/cursorfleet/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-222?style=flat-square&logo=github" alt="Documentation site" /></a>
+  <a href="https://pypi.org/project/cursorfleet/"><img src="https://img.shields.io/pypi/v/cursorfleet.svg" alt="PyPI version" /></a>
+  <a href="https://m9nx.github.io/cursorfleet/"><img src="https://img.shields.io/badge/docs-m9nx.github.io-222?style=flat-square&logo=readthedocs&logoColor=white" alt="Documentation site" /></a>
 </p>
 
 <p>
-  <a href="https://m9nx.github.io/cursorfleet/">Website</a>
+  <a href="https://m9nx.github.io/cursorfleet/">Documentation</a>
   ·
-  <a href="docs/quickstart.md">Quickstart</a>
+  <a href="https://pypi.org/project/cursorfleet/">PyPI</a>
+  ·
+  <a href="https://m9nx.github.io/cursorfleet/getting-started/quickstart/">Quickstart</a>
   ·
   <a href="docs/demo.md">Demo</a>
   ·
@@ -72,7 +76,9 @@ are doing what, from passive hooks and read-only git, without sending anything a
 
 ## Status
 
-**Pre-alpha, not released.** There is no PyPI package, tag or GitHub release yet.
+**Pre-alpha.** **[v0.1.0](https://github.com/M9nx/cursorfleet/releases/tag/v0.1.0)** is on
+[PyPI](https://pypi.org/project/cursorfleet/) and
+[GitHub Releases](https://github.com/M9nx/cursorfleet/releases). Latest on PyPI: **0.1.1**; `main` may be ahead.
 
 - v0.1 is **Observe**: no enforcement, no forced approvals, and no cloud-agent visibility
   (local Cursor sessions only). It is not a security boundary: a malicious or prompt-injected
@@ -99,16 +105,29 @@ are doing what, from passive hooks and read-only git, without sending anything a
 
 ## Install
 
-Needs Python 3.11+ and git. Until it is published, install from a checkout:
+Needs Python 3.11+ and git.
 
 ```bash
-git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
-uv tool install .            # or: pipx install .
+uv tool install cursorfleet    # or: pipx install cursorfleet
 cursorfleet --version
 ```
 
-(Once released: `uv tool install cursorfleet` or `pipx install cursorfleet`; see the
-[release checklist](docs/release-checklist.md).)
+From a git checkout (contributors or unreleased `main`):
+
+```bash
+git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
+uv tool install .
+```
+
+See the [installation guide](https://m9nx.github.io/cursorfleet/getting-started/installation/)
+on the docs site and the [release checklist](docs/release-checklist.md).
+
+Optional container (shows under [GitHub Packages](https://github.com/M9nx?tab=packages&repo_name=cursorfleet);
+install with pip for normal use):
+
+```bash
+docker run --rm ghcr.io/m9nx/cursorfleet:0.1.0 --help
+```
 
 ## Quickstart
 
@@ -123,8 +142,9 @@ cursorfleet status --json             # stable machine-readable snapshot for scr
 cursorfleet uninstall                 # remove exactly what init added
 ```
 
-Full walkthrough: [docs/quickstart.md](docs/quickstart.md). No Cursor handy? Run the
-[synthetic demo](docs/demo.md): `scripts/demo.sh`.
+Full walkthrough: [Quickstart on the docs site](https://m9nx.github.io/cursorfleet/getting-started/quickstart/)
+(in-repo: [docs/quickstart.md](docs/quickstart.md)). No Cursor handy? Run the
+[synthetic demo](docs/demo.md) (`scripts/demo.sh`).
 
 Dashboard keys: `o` overview, `l` timeline, `w` worktrees, `g` gates, `e` evidence, `v`
 violations (v0.2 placeholder), `/` filter, `p` pin, `t` tiles (160+ columns), `r` re-read,
@@ -134,7 +154,10 @@ gate tiles are heuristic and non-authoritative, not proof that anything passed.
 
 ## Documentation
 
-[Quickstart](docs/quickstart.md) · [governance model](docs/governance.md) ·
+**[Docs site (GitHub Pages)](https://m9nx.github.io/cursorfleet/)** — start with
+[Getting started](https://m9nx.github.io/cursorfleet/getting-started/installation/).
+
+In-repo: [Quickstart](docs/quickstart.md) · [governance model](docs/governance.md) ·
 [demo](docs/demo.md) · [kit reference](docs/kit.md) · [TUI](docs/tui.md) ·
 [`status --json`](docs/status-json.md) · [product contract](docs/product-contract.md) ·
 [architecture](docs/architecture.md) · [privacy](docs/privacy.md) ·

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/README.md

@@ -12,13 +12,16 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
   <img src="https://img.shields.io/badge/status-pre--alpha-orange.svg" alt="Status: pre-alpha" />
   <img src="https://img.shields.io/badge/python-3.11%2B-blue.svg" alt="Python 3.11+" />
-  <a href="https://m9nx.github.io/cursorfleet/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-222?style=flat-square&logo=github" alt="Documentation site" /></a>
+  <a href="https://pypi.org/project/cursorfleet/"><img src="https://img.shields.io/pypi/v/cursorfleet.svg" alt="PyPI version" /></a>
+  <a href="https://m9nx.github.io/cursorfleet/"><img src="https://img.shields.io/badge/docs-m9nx.github.io-222?style=flat-square&logo=readthedocs&logoColor=white" alt="Documentation site" /></a>
 </p>
 
 <p>
-  <a href="https://m9nx.github.io/cursorfleet/">Website</a>
+  <a href="https://m9nx.github.io/cursorfleet/">Documentation</a>
   ·
-  <a href="docs/quickstart.md">Quickstart</a>
+  <a href="https://pypi.org/project/cursorfleet/">PyPI</a>
+  ·
+  <a href="https://m9nx.github.io/cursorfleet/getting-started/quickstart/">Quickstart</a>
   ·
   <a href="docs/demo.md">Demo</a>
   ·
@@ -34,7 +37,9 @@ are doing what, from passive hooks and read-only git, without sending anything a
 
 ## Status
 
-**Pre-alpha, not released.** There is no PyPI package, tag or GitHub release yet.
+**Pre-alpha.** **[v0.1.0](https://github.com/M9nx/cursorfleet/releases/tag/v0.1.0)** is on
+[PyPI](https://pypi.org/project/cursorfleet/) and
+[GitHub Releases](https://github.com/M9nx/cursorfleet/releases). Latest on PyPI: **0.1.1**; `main` may be ahead.
 
 - v0.1 is **Observe**: no enforcement, no forced approvals, and no cloud-agent visibility
   (local Cursor sessions only). It is not a security boundary: a malicious or prompt-injected
@@ -61,16 +66,29 @@ are doing what, from passive hooks and read-only git, without sending anything a
 
 ## Install
 
-Needs Python 3.11+ and git. Until it is published, install from a checkout:
+Needs Python 3.11+ and git.
 
 ```bash
-git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
-uv tool install .            # or: pipx install .
+uv tool install cursorfleet    # or: pipx install cursorfleet
 cursorfleet --version
 ```
 
-(Once released: `uv tool install cursorfleet` or `pipx install cursorfleet`; see the
-[release checklist](docs/release-checklist.md).)
+From a git checkout (contributors or unreleased `main`):
+
+```bash
+git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
+uv tool install .
+```
+
+See the [installation guide](https://m9nx.github.io/cursorfleet/getting-started/installation/)
+on the docs site and the [release checklist](docs/release-checklist.md).
+
+Optional container (shows under [GitHub Packages](https://github.com/M9nx?tab=packages&repo_name=cursorfleet);
+install with pip for normal use):
+
+```bash
+docker run --rm ghcr.io/m9nx/cursorfleet:0.1.0 --help
+```
 
 ## Quickstart
 
@@ -85,8 +103,9 @@ cursorfleet status --json             # stable machine-readable snapshot for scr
 cursorfleet uninstall                 # remove exactly what init added
 ```
 
-Full walkthrough: [docs/quickstart.md](docs/quickstart.md). No Cursor handy? Run the
-[synthetic demo](docs/demo.md): `scripts/demo.sh`.
+Full walkthrough: [Quickstart on the docs site](https://m9nx.github.io/cursorfleet/getting-started/quickstart/)
+(in-repo: [docs/quickstart.md](docs/quickstart.md)). No Cursor handy? Run the
+[synthetic demo](docs/demo.md) (`scripts/demo.sh`).
 
 Dashboard keys: `o` overview, `l` timeline, `w` worktrees, `g` gates, `e` evidence, `v`
 violations (v0.2 placeholder), `/` filter, `p` pin, `t` tiles (160+ columns), `r` re-read,
@@ -96,7 +115,10 @@ gate tiles are heuristic and non-authoritative, not proof that anything passed.
 
 ## Documentation
 
-[Quickstart](docs/quickstart.md) · [governance model](docs/governance.md) ·
+**[Docs site (GitHub Pages)](https://m9nx.github.io/cursorfleet/)** — start with
+[Getting started](https://m9nx.github.io/cursorfleet/getting-started/installation/).
+
+In-repo: [Quickstart](docs/quickstart.md) · [governance model](docs/governance.md) ·
 [demo](docs/demo.md) · [kit reference](docs/kit.md) · [TUI](docs/tui.md) ·
 [`status --json`](docs/status-json.md) · [product contract](docs/product-contract.md) ·
 [architecture](docs/architecture.md) · [privacy](docs/privacy.md) ·

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/docs/evidence/b0-live-validation-2026-10-12.md

@@ -1,7 +1,7 @@
 # B0 live validation (maintainer)
 
-Status: **checklist for owner** — fill during Linux Cursor IDE session before calling v0.1.0
-**product-accepted** for scenarios 1, 2, and 5.
+Status: **checklist for owner** — fill during Linux Cursor IDE session before **PyPI publish**
+(`RELEASE_ENABLED`). Tag `v0.1.0` is already on GitHub; scenarios 1, 2, and 5 gate product claims.
 
 | Field | Value |
 | --- | --- |

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/docs/evidence/external-alpha-results.md

@@ -2,7 +2,8 @@
 
 Status: **not started** (2026-10-12).
 
-v0.1.0 release decision: external alpha is **post-tag** (see [`../status.md`](../status.md)).
+v0.1.0 is **tagged**; run external alpha after PyPI install path is available (see
+[`../external-alpha.md`](../external-alpha.md), [`v0.1.1-backlog.md`](v0.1.1-backlog.md)).
 Metrics from [`../external-alpha.md`](../external-alpha.md) will be recorded here when testers run.
 
 | Metric | Target | Result |

cursorfleet-0.1.1/docs/evidence/pypi-trusted-publishing-setup.md

@@ -0,0 +1,36 @@
+# PyPI Trusted Publishing setup (owner)
+
+Status: **GitHub configured** (2026-10-12): `pypi` environment with required reviewer `M9nx`, `RELEASE_ENABLED=true`. **PyPI pending publisher** still required in UI (see below).
+
+## PyPI project (first time) — **you must do this in the browser**
+
+Log in at [pypi.org](https://pypi.org) as **M9nx**, then **Account settings → Publishing** (or [manage/account/publishing](https://pypi.org/manage/account/publishing/)) → **Add a new pending publisher**. Values must match GitHub OIDC exactly (from failed run `38301917759`):
+
+| Field | Value |
+| --- | --- |
+| PyPI Project Name | `cursorfleet` (new project; created on first upload) |
+| Owner | `M9nx` |
+| Repository name | `cursorfleet` |
+| Workflow name | `release.yml` |
+| Environment name | `pypi` |
+
+Save the publisher, then re-run the failed **publish to PyPI** job on the latest [Release workflow](https://github.com/M9nx/cursorfleet/actions/workflows/release.yml) for tag `v0.1.0` and approve the **`pypi`** environment again.
+
+## GitHub repository
+
+Done on `M9nx/cursorfleet`:
+
+1. Environment **`pypi`** with required reviewer **M9nx**.
+2. Repository variable **`RELEASE_ENABLED`** = **`true`** (kill switch in [release.yml](../../.github/workflows/release.yml)).
+
+Optional: tag ruleset for `v*`.
+
+## Release sequence
+
+1. All gates in [v01-release-ready.md](v01-release-ready.md) closed.
+2. Push tag `v0.1.0` matching [pyproject.toml](../../pyproject.toml) version.
+3. Workflow creates **draft** GitHub release with wheel/sdist.
+4. Approve **pypi** environment deployment after reviewing assets.
+5. Publish GitHub release notes manually.
+
+Do **not** enable `RELEASE_ENABLED` until SO-01 and B0 live rows are PASS.

cursorfleet-0.1.1/docs/evidence/release-v0.1.0-owner-runbook.md

@@ -0,0 +1,31 @@
+# v0.1.0 owner runbook (post-tag)
+
+Use this after the agent/repo prep; order matches [v01-release-ready.md](v01-release-ready.md).
+
+## 1. Live Cursor (Linux IDE)
+
+1. Follow [quickstart §4](../quickstart.md) two-run recipe.
+2. Complete [b0-live-validation-2026-10-12.md](b0-live-validation-2026-10-12.md) scenarios 1, 2, 5.
+3. Record [so01-permission-hooks.md](so01-permission-hooks.md) for `preToolUse` and `subagentStart`.
+4. Run 13B paired measurement; fill [latency-13b-linux-ide.md](latency-13b-linux-ide.md).
+5. Optional: add sanitized [active-run-screenshot.png](active-run-screenshot.png) and link from public docs.
+
+Commit evidence updates on `main` (signed commits).
+
+## 2. PyPI
+
+1. Re-check PyPI name `cursorfleet` ([adr-0005-naming-gate.md](adr-0005-naming-gate.md)).
+2. Complete [pypi-trusted-publishing-setup.md](pypi-trusted-publishing-setup.md).
+3. Set repository variable `RELEASE_ENABLED=true` only when ready.
+
+## 3. Publish
+
+1. Open the **draft** [GitHub release for v0.1.0](https://github.com/M9nx/cursorfleet/releases).
+2. Paste/edit notes from CHANGELOG `[0.1.0]`.
+3. Publish the GitHub release (not draft).
+4. Approve the **pypi** environment deployment for the tag workflow (or re-run publish job if needed).
+
+## 4. Post-publish
+
+1. Run [external alpha](../external-alpha.md); record [external-alpha-results.md](external-alpha-results.md).
+2. Track [v0.1.1-backlog.md](v0.1.1-backlog.md) (attach picker, etc.).

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/docs/evidence/v0.1.1-backlog.md

@@ -1,6 +1,6 @@
 # v0.1.1 backlog (post-v0.1.0)
 
-- TUI attach picker for suggested sessions (B0 scenario 5 UX)
+- ~~TUI attach picker for suggested sessions (B0 scenario 5 UX)~~ — Active run: select suggested row, Enter to attach
 - Close B0 live validation checklist if still OPEN at tag time
 - SO-01 and latency 13B evidence if still OPEN
 - ADR 0006: optional `migrate artifacts --yes`, digest dedupe

cursorfleet-0.1.1/docs/evidence/v01-release-baseline.md

@@ -0,0 +1,14 @@
+# v0.1.0 release baseline
+
+Last updated: 2026-10-12.
+
+| Field | Value |
+| --- | --- |
+| `main` HEAD | `df919a4803e2c2139346367660e931ccc291f4ac` |
+| Tag `v0.1.0` | `626db23` (0.1.0 tree + release-check mypy fixes) |
+| Version on `main` | `0.1.1.dev0` |
+| Tests (local) | 1010 passed, 1 deselected |
+| CI `main` | Green on `df919a4` |
+| Release workflow | Green on tag ([38298997744](https://github.com/M9nx/cursorfleet/actions/runs/38298997744)) |
+
+Tracking: [`v01-adr-truth-table.md`](v01-adr-truth-table.md), [`v01-release-ready.md`](v01-release-ready.md).

cursorfleet-0.1.1/docs/evidence/v01-release-ready.md

@@ -0,0 +1,23 @@
+# v0.1.0 tag readiness
+
+Last updated: 2026-10-12 (`main` at `df919a4`, tag `v0.1.0` → `626db23`).
+
+## Shipped
+
+| Item | Status |
+| --- | --- |
+| CI on `main` | Green ([workflow](https://github.com/M9nx/cursorfleet/actions/workflows/ci.yml)) |
+| Tag `v0.1.0` | Pushed; Release workflow green ([run](https://github.com/M9nx/cursorfleet/actions/runs/38298997744)) |
+| GitHub release | [CursorFleet v0.1.0](https://github.com/M9nx/cursorfleet/releases/tag/v0.1.0) published (wheel + sdist) |
+| `main` development | `0.1.1.dev0` |
+| Code/docs prep | Privacy default, run-scoped git, quickstart runs, ADR amendments, fixtures |
+
+## Before `RELEASE_ENABLED=true` and PyPI approve
+
+1. **B0 live** — [b0-live-validation-2026-10-12.md](b0-live-validation-2026-10-12.md) scenarios **1, 2, 5** + optional [active-run-screenshot.png](active-run-screenshot.png)
+2. **SO-01** — [so01-permission-hooks.md](so01-permission-hooks.md) on live Cursor
+3. **Latency 13B** — [latency-13b-linux-ide.md](latency-13b-linux-ide.md) or dated PARTIAL + platform narrow
+4. **PyPI** — [pypi-trusted-publishing-setup.md](pypi-trusted-publishing-setup.md) (`pypi` env, Trusted Publishing, day-of name check)
+5. **Publish** — GitHub release is live; set `RELEASE_ENABLED=true`, approve `pypi` job to upload PyPI
+
+External alpha remains **post-PyPI** ([status.md](../status.md), [v0.1.1-backlog.md](v0.1.1-backlog.md)).

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/docs/quickstart.md

@@ -11,8 +11,9 @@
 
 ## 1. Install
 
-CursorFleet needs Python 3.11 or newer and `git`. It is **not on PyPI yet**; until the owner
-publishes it, install from a checkout or a built wheel.
+CursorFleet needs Python 3.11 or newer and `git`. **v0.1.0** is tagged on GitHub; PyPI publish
+awaits owner approval (`RELEASE_ENABLED`). Until then, install from a checkout, the draft release
+assets, or a local wheel.
 
 ```bash
 # from a checkout (needs uv: https://docs.astral.sh/uv/)

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/docs/status.md

@@ -1,6 +1,7 @@
 # Project status
 
-Last updated: 2026-10-12. CursorFleet is unofficial and pre-release; nothing is published on PyPI yet.
+Last updated: 2026-10-12. CursorFleet is unofficial; **v0.1.0** is tagged on GitHub. PyPI publish
+awaits `RELEASE_ENABLED` and owner approval (see [v01-release-ready.md](evidence/v01-release-ready.md)).
 Everything here was written and reviewed by the same author: it is a self-review, not an
 independent audit.
 

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/public-docs/getting-started/installation.md

@@ -1,25 +1,31 @@
 # Installation
 
-CursorFleet needs **Python 3.11+** and **git**. It is **not on PyPI**. Until a
-release exists, install from a git checkout.
+CursorFleet needs **Python 3.11+** and **git**.
 
 **Unofficial and pre-alpha.** CursorFleet is not affiliated with or endorsed by
 Anysphere or Cursor.
 
-## From a checkout
+## From PyPI (recommended)
+
+[v0.1.0](https://pypi.org/project/cursorfleet/) and later:
 
 ```bash
-git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
-uv tool install .            # or: pipx install .
+uv tool install cursorfleet    # or: pipx install cursorfleet
 cursorfleet --version
 ```
 
 `uv` is documented at [docs.astral.sh/uv](https://docs.astral.sh/uv/). `pipx`
 is an alternative for the same console scripts.
 
-Once a first release exists, the intended commands are
-`uv tool install cursorfleet` or `pipx install cursorfleet`. Those are **not**
-available yet.
+## From a checkout
+
+For contributors or unreleased `main`:
+
+```bash
+git clone https://github.com/M9nx/cursorfleet && cd cursorfleet
+uv tool install .            # or: pipx install .
+cursorfleet --version
+```
 
 ## Check the hook entry point
 

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/public-docs/index.md

@@ -18,8 +18,10 @@ Cursor. "Cursor" is a trademark of its respective owner. The name
 
 ## Status
 
-**Pre-alpha, not released.** There is no PyPI package, tag, or GitHub release.
-Install from a git checkout. See [Installation](getting-started/installation.md).
+**Pre-alpha.** [v0.1.0](https://github.com/M9nx/cursorfleet/releases/tag/v0.1.0) is on
+[PyPI](https://pypi.org/project/cursorfleet/) and
+[GitHub Releases](https://github.com/M9nx/cursorfleet/releases). See
+[Installation](getting-started/installation.md) (`pipx` / `uv tool install cursorfleet`).
 
 - v0.1 is **Observe** only: no enforcement, no forced approvals, and no
   cloud-agent visibility (local Cursor sessions only). It is not a security

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cursorfleet"
-version = "0.1.0"
+version = "0.1.1"
 description = "Unofficial local TUI and workflow harness (observe-only) for Cursor agent teams."
 readme = "README.md"
 license = "MIT"
@@ -40,12 +40,13 @@ dependencies = [
 watch = ["watchfiles>=0.21"]
 
 [project.urls]
-Homepage = "https://github.com/M9nx/cursorfleet"
-Documentation = "https://github.com/M9nx/cursorfleet/tree/main/docs"
+Homepage = "https://m9nx.github.io/cursorfleet/"
+Documentation = "https://m9nx.github.io/cursorfleet/"
 Source = "https://github.com/M9nx/cursorfleet"
 Issues = "https://github.com/M9nx/cursorfleet/issues"
 Changelog = "https://github.com/M9nx/cursorfleet/blob/main/CHANGELOG.md"
 Security = "https://github.com/M9nx/cursorfleet/blob/main/SECURITY.md"
+"Release notes" = "https://github.com/M9nx/cursorfleet/releases/tag/v0.1.1"
 
 [project.scripts]
 cursorfleet = "cursorfleet.cli.main:app"

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/src/cursorfleet/__init__.py

@@ -4,6 +4,6 @@ Keep this module import-free (stdlib only, no heavy imports): the hook hot path
 imports ``cursorfleet`` on every hook invocation.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 __all__ = ["__version__"]

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/src/cursorfleet/tui/app.py

@@ -26,6 +26,7 @@ from cursorfleet import __version__
 from cursorfleet.adapters.cursor.kit_probe import HooksKitState
 from cursorfleet.events.models import Event
 from cursorfleet.state.event_store import DEFAULT_PAGE, MAX_PAGE, EventFilter
+from cursorfleet.state.run_store import attach_session
 from cursorfleet.tui import views
 from cursorfleet.tui.data import DataSource, FleetData
 from cursorfleet.tui.filters import parse_timeline_filter
@@ -522,11 +523,35 @@ class CursorFleetApp(App[None]):
         widget.action_cursor_down() if step > 0 else widget.action_cursor_up()
 
     def action_open_detail(self) -> None:
+        key = self._selected_key()
+        if (
+            self.view == "active_run"
+            and key is not None
+            and key.startswith("sug:")
+            and key != "ar:sug:h"
+        ):
+            self._attach_suggested_session(key[4:])
+            return
         if self._mode == SINGLE:
             self.detail_open = True
             self._apply_layout(self._width)
         self.query_one("#detail", VerticalScroll).focus()
 
+    def _attach_suggested_session(self, session_id: str) -> None:
+        run = self.data.primary_run
+        runtime = self.data.runtime_dir
+        if run is None or runtime is None:
+            self.flash("no active run")
+            return
+        if run.run_id.startswith("inferred:"):
+            self.flash("start a run first: cursorfleet run start --task <slug>")
+            return
+        if not attach_session(runtime, run.run_id, session_id):
+            self.flash("attach failed (archived or missing run)")
+            return
+        self.flash(f"attached {safe(session_id, 32)}")
+        self.run_worker(self.refresh_data(), exclusive=False)
+
     def action_pin(self) -> None:
         key = self._selected_key()
         if self.view != "overview" or key is None or key not in self.data.bundles:

{cursorfleet-0.1.0 → cursorfleet-0.1.1}/src/cursorfleet/tui/help.py

@@ -21,7 +21,7 @@ KEYS: tuple[tuple[str, str], ...] = (
     ("g", "Observations: verification signals, display-only (no pass/fail score)"),
     ("e", "Evidence: observed runs vs SELF-REPORTED declarations"),
     ("j / k, arrows", "Move down / up (scrolls the detail when it has focus)"),
-    ("Enter", "Open the detail for the selected item"),
+    ("Enter", "Open detail; on Active run, attach a suggested session"),
     ("Esc", "Back: leave detail, close or clear the filter"),
     ("/", "Filter (timeline: agent: session: kind: risk: source: file: since: until: words)"),
     ("m", "Timeline: load more events"),