From 546097f5e77893008f27d56569e4e1c2527ac011 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:24:47 -0400 Subject: [PATCH 01/13] docs: revise roadmap -- promote SSE/dashboard/docker to near-term, A2A to medium-term, remove Codex/Copilot, fix encoding --- ROADMAP.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index 3d3e3b68..5f03f766 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -3,38 +3,38 @@ This roadmap reflects current plans. Priorities shift based on community feedback. Have an idea? [Open a feature request](https://github.com/Apra-Labs/apra-fleet/issues/new/choose). -Items marked 🌱 are good first issues for new contributors. +Items marked [*] are good first issues for new contributors. --- ## Near-term (next 1-2 sprints) -- [ ] **npm publish** — Publish to npm so users can `npx apra-fleet install` 🌱 -- [ ] **Cursor / Windsurf integration guide** — Step-by-step docs for non-Claude-Code AI assistants 🌱 -- [ ] **Codex CLI & GitHub Copilot support** — First-class support as member agent providers — coming soon 🚀 -- [ ] **Member groups / tags** — Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups -- [ ] **Session log export** — Export prompt execution history as markdown 🌱 +- [ ] **npm publish** -- Publish to npm so users can `npx apra-fleet install` [*] +- [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network +- [ ] **Web dashboard** -- Browser UI for fleet status, member management, and live prompt monitoring [*] +- [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members +- [ ] **Cursor / Windsurf integration guide** -- Step-by-step docs for non-Claude-Code AI assistants [*] +- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups +- [ ] **Session log export** -- Export prompt execution history as markdown [*] ## Medium-term (3-6 months) -- [ ] **Expanded member targets** — Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members -- [ ] **Web dashboard** — Browser UI for fleet status and member management (foundation in `dashboard/`) 🌱 -- [ ] **Plugin system** — Community-built plugins for custom tools and providers -- [ ] **Result aggregation** — Merge outputs from parallel member executions into a unified report -- [ ] **Cost dashboard** — Visualize token and cloud spend across members +- [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator +- [ ] **Plugin system** -- Community-built plugins for custom tools and providers +- [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report +- [ ] **Cost dashboard** -- Visualize token and cloud spend across members ## Long-term (6+ months) -- [ ] **Agent-to-agent communication** — Members communicate directly, not only through coordinator -- [ ] **Distributed task queue** — Priority-based job scheduling with retry and dead-letter handling -- [ ] **Fleet-as-a-Service** — Hosted version for teams that don't want to self-host -- [ ] **Terraform / Pulumi provider** — Infrastructure-as-code for fleet topology -- [ ] **Audit log** — Immutable log of all fleet operations for enterprise governance 🌱 -- [ ] **Multi-fleet federation** — Connect multiple fleet servers for cross-team orchestration +- [ ] **Distributed task queue** -- Priority-based job scheduling with retry and dead-letter handling +- [ ] **Fleet-as-a-Service** -- Hosted version for teams that don't want to self-host +- [ ] **Terraform / Pulumi provider** -- Infrastructure-as-code for fleet topology +- [ ] **Audit log** -- Immutable log of all fleet operations for enterprise governance [*] +- [ ] **Multi-fleet federation** -- Connect multiple fleet servers for cross-team orchestration --- ## Contributing -Pick any item above (especially 🌱 ones), open an issue to discuss your approach, then submit a PR. +Pick any item above (especially [*] ones), open an issue to discuss your approach, then submit a PR. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. From 50f9bdb2c3e739491815096532d1946c2eecae86 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:25:20 -0400 Subject: [PATCH 02/13] docs: remove Cursor/Windsurf integration guide from roadmap --- ROADMAP.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ROADMAP.md b/ROADMAP.md index 5f03f766..2c1adb02 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -13,7 +13,6 @@ Items marked [*] are good first issues for new contributors. - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network - [ ] **Web dashboard** -- Browser UI for fleet status, member management, and live prompt monitoring [*] - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members -- [ ] **Cursor / Windsurf integration guide** -- Step-by-step docs for non-Claude-Code AI assistants [*] - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups - [ ] **Session log export** -- Export prompt execution history as markdown [*] From 6241df5afcd627a6703ce586b3924da5ff41859e Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:26:07 -0400 Subject: [PATCH 03/13] docs: improve session log export roadmap item --- ROADMAP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ROADMAP.md b/ROADMAP.md index 2c1adb02..d6c5d014 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -14,7 +14,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **Web dashboard** -- Browser UI for fleet status, member management, and live prompt monitoring [*] - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups -- [ ] **Session log export** -- Export prompt execution history as markdown [*] +- [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] ## Medium-term (3-6 months) From 6e4a1ce296fe080dc3a84a07559e73621dc10880 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:31:32 -0400 Subject: [PATCH 04/13] docs: fold cost dashboard into web dashboard item --- ROADMAP.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index d6c5d014..795719d9 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -11,7 +11,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **npm publish** -- Publish to npm so users can `npx apra-fleet install` [*] - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network -- [ ] **Web dashboard** -- Browser UI for fleet status, member management, and live prompt monitoring [*] +- [ ] **Web dashboard** -- Browser UI for fleet status, member management, live prompt monitoring, and token/cloud cost visibility [*] - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] @@ -21,7 +21,6 @@ Items marked [*] are good first issues for new contributors. - [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator - [ ] **Plugin system** -- Community-built plugins for custom tools and providers - [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report -- [ ] **Cost dashboard** -- Visualize token and cloud spend across members ## Long-term (6+ months) From 4b82e489aaa3f8757163c74d42e4edc6f8301792 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:33:44 -0400 Subject: [PATCH 05/13] docs: add memory plane integration to near-term, move expanded targets to medium-term --- ROADMAP.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/ROADMAP.md b/ROADMAP.md index 795719d9..f9027b52 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -12,13 +12,14 @@ Items marked [*] are good first issues for new contributors. - [ ] **npm publish** -- Publish to npm so users can `npx apra-fleet install` [*] - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network - [ ] **Web dashboard** -- Browser UI for fleet status, member management, live prompt monitoring, and token/cloud cost visibility [*] -- [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members +- [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices (e.g. DeepWiki) so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; reduces drift and cuts initial exploration cost - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] ## Medium-term (3-6 months) - [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator +- [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members - [ ] **Plugin system** -- Community-built plugins for custom tools and providers - [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report From 30f5b1e93be2a19e650d1f6218828e2832b6ce81 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:35:57 -0400 Subject: [PATCH 06/13] docs: demote member groups/tags to bottom of medium-term --- ROADMAP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ROADMAP.md b/ROADMAP.md index f9027b52..53559f51 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -13,7 +13,6 @@ Items marked [*] are good first issues for new contributors. - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network - [ ] **Web dashboard** -- Browser UI for fleet status, member management, live prompt monitoring, and token/cloud cost visibility [*] - [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices (e.g. DeepWiki) so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; reduces drift and cuts initial exploration cost -- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] ## Medium-term (3-6 months) @@ -22,6 +21,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members - [ ] **Plugin system** -- Community-built plugins for custom tools and providers - [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report +- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups ## Long-term (6+ months) From f5d0b7d5027c3c5c9e160e8a4762c4acb7062611 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:37:28 -0400 Subject: [PATCH 07/13] docs: adjust timeframes, promote Fleet-as-a-Service and multi-fleet-federation to top of long-term --- ROADMAP.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index 53559f51..2daae401 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -15,7 +15,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices (e.g. DeepWiki) so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; reduces drift and cuts initial exploration cost - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] -## Medium-term (3-6 months) +## Medium-term (1-2 months) - [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members @@ -23,13 +23,13 @@ Items marked [*] are good first issues for new contributors. - [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups -## Long-term (6+ months) +## Long-term (3+ months) -- [ ] **Distributed task queue** -- Priority-based job scheduling with retry and dead-letter handling - [ ] **Fleet-as-a-Service** -- Hosted version for teams that don't want to self-host +- [ ] **Multi-fleet federation** -- Connect multiple fleet servers for cross-team orchestration +- [ ] **Distributed task queue** -- Priority-based job scheduling with retry and dead-letter handling - [ ] **Terraform / Pulumi provider** -- Infrastructure-as-code for fleet topology - [ ] **Audit log** -- Immutable log of all fleet operations for enterprise governance [*] -- [ ] **Multi-fleet federation** -- Connect multiple fleet servers for cross-team orchestration --- From e097cf424277ea74ac61d9a6cc065da0a5539037 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:44:42 -0400 Subject: [PATCH 08/13] docs: revise roadmap based on discussions analysis -- add playbooks, PM lifecycle, extension layer, discussion links, fix misrepresentations --- ROADMAP.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index 2daae401..bcc99d0f 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -11,15 +11,17 @@ Items marked [*] are good first issues for new contributors. - [ ] **npm publish** -- Publish to npm so users can `npx apra-fleet install` [*] - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network -- [ ] **Web dashboard** -- Browser UI for fleet status, member management, live prompt monitoring, and token/cloud cost visibility [*] -- [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices (e.g. DeepWiki) so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; reduces drift and cuts initial exploration cost +- [ ] **Web dashboard** -- Browser UI for fleet topology, member status, live prompt monitoring, token/cloud cost visibility, git activity, and audit trail; VS Code extension embeds the same view with clickable file paths ([discussion #188](https://github.com/Apra-Labs/apra-fleet/discussions/188)) +- [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; encompasses both persistent inter-session memory ([RFC #265](https://github.com/Apra-Labs/apra-fleet/discussions/265)) and sprint-accumulated knowledge graphs ([discussion #249](https://github.com/Apra-Labs/apra-fleet/discussions/249)) - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] ## Medium-term (1-2 months) -- [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator +- [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator ([discussion #196](https://github.com/Apra-Labs/apra-fleet/discussions/196)) +- [ ] **Playbooks** -- JIT-compiled orchestration sequences: write environment-neutral runbooks once, fleet compiles them to native scripts per device and caches them; zero LLM cost on repeat runs with autonomous repair on failure ([discussion #194](https://github.com/Apra-Labs/apra-fleet/discussions/194)) +- [ ] **PM as full product lifecycle manager** -- Extend the PM skill through deploy, integration verification, quality grading, log monitoring, and backlog reprioritization; closes the loop beyond PR approval ([discussion #198](https://github.com/Apra-Labs/apra-fleet/discussions/198)) +- [ ] **Extension layer** -- Org-private skills and template overrides that survive fleet updates via a shadowing directory (`~/.apra-fleet/extensions/`); foundation for a community marketplace ([discussion #195](https://github.com/Apra-Labs/apra-fleet/discussions/195)) - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members -- [ ] **Plugin system** -- Community-built plugins for custom tools and providers - [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups @@ -27,7 +29,6 @@ Items marked [*] are good first issues for new contributors. - [ ] **Fleet-as-a-Service** -- Hosted version for teams that don't want to self-host - [ ] **Multi-fleet federation** -- Connect multiple fleet servers for cross-team orchestration -- [ ] **Distributed task queue** -- Priority-based job scheduling with retry and dead-letter handling - [ ] **Terraform / Pulumi provider** -- Infrastructure-as-code for fleet topology - [ ] **Audit log** -- Immutable log of all fleet operations for enterprise governance [*] From 466e5b59e083a708c055c7add81633f4ee9b2035 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:47:55 -0400 Subject: [PATCH 09/13] docs: remove result aggregation, link member groups/tags to PR #238 --- ROADMAP.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index bcc99d0f..7b0c7229 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -22,8 +22,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **PM as full product lifecycle manager** -- Extend the PM skill through deploy, integration verification, quality grading, log monitoring, and backlog reprioritization; closes the loop beyond PR approval ([discussion #198](https://github.com/Apra-Labs/apra-fleet/discussions/198)) - [ ] **Extension layer** -- Org-private skills and template overrides that survive fleet updates via a shadowing directory (`~/.apra-fleet/extensions/`); foundation for a community marketplace ([discussion #195](https://github.com/Apra-Labs/apra-fleet/discussions/195)) - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members -- [ ] **Result aggregation** -- Merge outputs from parallel member executions into a unified report -- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups +- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups; categorized grouping in status output ([PR #238](https://github.com/Apra-Labs/apra-fleet/pull/238)) ## Long-term (3+ months) From 3673552a753f895f7e87804ee7d1387d621b7b71 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:48:36 -0400 Subject: [PATCH 10/13] docs: move member groups/tags to near-term (PR already open) --- ROADMAP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ROADMAP.md b/ROADMAP.md index 7b0c7229..edbacd5c 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -14,6 +14,7 @@ Items marked [*] are good first issues for new contributors. - [ ] **Web dashboard** -- Browser UI for fleet topology, member status, live prompt monitoring, token/cloud cost visibility, git activity, and audit trail; VS Code extension embeds the same view with clickable file paths ([discussion #188](https://github.com/Apra-Labs/apra-fleet/discussions/188)) - [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; encompasses both persistent inter-session memory ([RFC #265](https://github.com/Apra-Labs/apra-fleet/discussions/265)) and sprint-accumulated knowledge graphs ([discussion #249](https://github.com/Apra-Labs/apra-fleet/discussions/249)) - [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] +- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups; categorized grouping in status output ([PR #238](https://github.com/Apra-Labs/apra-fleet/pull/238)) ## Medium-term (1-2 months) @@ -22,7 +23,6 @@ Items marked [*] are good first issues for new contributors. - [ ] **PM as full product lifecycle manager** -- Extend the PM skill through deploy, integration verification, quality grading, log monitoring, and backlog reprioritization; closes the loop beyond PR approval ([discussion #198](https://github.com/Apra-Labs/apra-fleet/discussions/198)) - [ ] **Extension layer** -- Org-private skills and template overrides that survive fleet updates via a shadowing directory (`~/.apra-fleet/extensions/`); foundation for a community marketplace ([discussion #195](https://github.com/Apra-Labs/apra-fleet/discussions/195)) - [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members -- [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups; categorized grouping in status output ([PR #238](https://github.com/Apra-Labs/apra-fleet/pull/238)) ## Long-term (3+ months) From b53b080daec37620e5b396d8b721b0523697bb73 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:51:00 -0400 Subject: [PATCH 11/13] docs: link open PRs and issues into roadmap, add multiple providers and Slack notifications --- ROADMAP.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index edbacd5c..45faa167 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -12,24 +12,26 @@ Items marked [*] are good first issues for new contributors. - [ ] **npm publish** -- Publish to npm so users can `npx apra-fleet install` [*] - [ ] **HTTP+SSE transport** -- MCP HTTP+SSE transport enabling remote members to connect over the network - [ ] **Web dashboard** -- Browser UI for fleet topology, member status, live prompt monitoring, token/cloud cost visibility, git activity, and audit trail; VS Code extension embeds the same view with clickable file paths ([discussion #188](https://github.com/Apra-Labs/apra-fleet/discussions/188)) -- [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; encompasses both persistent inter-session memory ([RFC #265](https://github.com/Apra-Labs/apra-fleet/discussions/265)) and sprint-accumulated knowledge graphs ([discussion #249](https://github.com/Apra-Labs/apra-fleet/discussions/249)) -- [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard [*] +- [ ] **Memory plane integration** -- Connect fleet agents to codebase knowledge indices so task planning starts from a structured map of architecture and relevant files rather than blind token-expensive discovery; encompasses persistent inter-session memory and sprint-accumulated knowledge graphs ([RFC #265](https://github.com/Apra-Labs/apra-fleet/discussions/265), [discussion #249](https://github.com/Apra-Labs/apra-fleet/discussions/249), [PR #266](https://github.com/Apra-Labs/apra-fleet/pull/266)) +- [ ] **Session log export** -- One-click markdown export of `fleet logs` output from the dashboard; builds on session history and listing work ([issue #189](https://github.com/Apra-Labs/apra-fleet/issues/189)) [*] - [ ] **Member groups / tags** -- Tag members (e.g. `gpu`, `build`, `test`) and target prompts at groups; categorized grouping in status output ([PR #238](https://github.com/Apra-Labs/apra-fleet/pull/238)) ## Medium-term (1-2 months) -- [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator ([discussion #196](https://github.com/Apra-Labs/apra-fleet/discussions/196)) +- [ ] **Agent-to-agent communication** -- Members communicate directly, not only through coordinator ([discussion #196](https://github.com/Apra-Labs/apra-fleet/discussions/196), [issue #152](https://github.com/Apra-Labs/apra-fleet/issues/152)) - [ ] **Playbooks** -- JIT-compiled orchestration sequences: write environment-neutral runbooks once, fleet compiles them to native scripts per device and caches them; zero LLM cost on repeat runs with autonomous repair on failure ([discussion #194](https://github.com/Apra-Labs/apra-fleet/discussions/194)) - [ ] **PM as full product lifecycle manager** -- Extend the PM skill through deploy, integration verification, quality grading, log monitoring, and backlog reprioritization; closes the loop beyond PR approval ([discussion #198](https://github.com/Apra-Labs/apra-fleet/discussions/198)) - [ ] **Extension layer** -- Org-private skills and template overrides that survive fleet updates via a shadowing directory (`~/.apra-fleet/extensions/`); foundation for a community marketplace ([discussion #195](https://github.com/Apra-Labs/apra-fleet/discussions/195)) -- [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members +- [ ] **Expanded member targets** -- Docker containers, Kubernetes pods, WSL instances, Azure VMs, and GCP VMs as first-class fleet members; includes per-instance data dir isolation for multi-fleet on the same machine ([PR #231](https://github.com/Apra-Labs/apra-fleet/pull/231)) +- [ ] **Multiple providers per member** -- Assign more than one LLM provider to a member and switch between them without re-registration ([issue #125](https://github.com/Apra-Labs/apra-fleet/issues/125)) +- [ ] **Slack notifications** -- Notify a Slack channel when members go offline, get blocked, or complete a task ([issue #77](https://github.com/Apra-Labs/apra-fleet/issues/77)) ## Long-term (3+ months) - [ ] **Fleet-as-a-Service** -- Hosted version for teams that don't want to self-host - [ ] **Multi-fleet federation** -- Connect multiple fleet servers for cross-team orchestration - [ ] **Terraform / Pulumi provider** -- Infrastructure-as-code for fleet topology -- [ ] **Audit log** -- Immutable log of all fleet operations for enterprise governance [*] +- [ ] **Audit log** -- Immutable append-only record of all fleet operations and secret usage for enterprise governance ([issue #159](https://github.com/Apra-Labs/apra-fleet/issues/159)) [*] --- From da5b1cf4eb4a1380541f3a6d84f471c2a542aed8 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 12:02:30 -0400 Subject: [PATCH 12/13] docs: add DeepWiki codebase wiki link to README and FAQ --- README.md | 1 + docs/FAQ.md | 13 +++++++++++++ 2 files changed, 14 insertions(+) diff --git a/README.md b/README.md index f8fe4529..5b697352 100644 --- a/README.md +++ b/README.md @@ -270,6 +270,7 @@ Want to build your own skill on top of Fleet? See [docs/writing-skills.md](docs/ | Topic | Link | |-------|------| +| Codebase wiki (architecture, internals, AI Q&A) | [DeepWiki](https://deepwiki.com/Apra-Labs/apra-fleet) | | Install, uninstall, the `--llm` flag | [docs/install.md](docs/install.md) | | Choosing a provider | [docs/provider-guide.md](docs/provider-guide.md) | | FAQ | [docs/FAQ.md](docs/FAQ.md) | diff --git a/docs/FAQ.md b/docs/FAQ.md index 9575f93e..bbf9dfa7 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -10,6 +10,19 @@ All questions and answers are maintained at: **[FAQ Index -- GitHub Discussions #127](https://github.com/Apra-Labs/apra-fleet/discussions/127)** +--- + +Want to explore the codebase or ask questions about how Fleet works internally? +The **[Fleet DeepWiki](https://deepwiki.com/Apra-Labs/apra-fleet)** has an AI assistant trained on the Fleet source code. + +Some useful starting points: + +- [How does execute_prompt work end-to-end?](https://deepwiki.com/Apra-Labs/apra-fleet/4.2-work-execution-tools) +- [How do I register and manage fleet members?](https://deepwiki.com/Apra-Labs/apra-fleet/4.1-member-lifecycle-tools) +- [What is the doer-reviewer workflow?](https://deepwiki.com/Apra-Labs/apra-fleet/7.1-sprint-lifecycle-and-doer-reviewer-loop) + +--- + Topics covered: - **Getting started** -- installation, device requirements, provider support From 18988d2ef937ff1cc3e99f3a7c7cd5e7be84b697 Mon Sep 17 00:00:00 2001 From: Bot Date: Fri, 29 May 2026 13:14:31 -0400 Subject: [PATCH 13/13] chore: remove docs/site folder --- docs/site/icons/icon.svg | 36 -- docs/site/index.html | 790 --------------------------------------- 2 files changed, 826 deletions(-) delete mode 100644 docs/site/icons/icon.svg delete mode 100644 docs/site/index.html diff --git a/docs/site/icons/icon.svg b/docs/site/icons/icon.svg deleted file mode 100644 index 1817854b..00000000 --- a/docs/site/icons/icon.svg +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/docs/site/index.html b/docs/site/index.html deleted file mode 100644 index fac479d3..00000000 --- a/docs/site/index.html +++ /dev/null @@ -1,790 +0,0 @@ - - - - - `n - Apra Fleet — Your AI Engineering Organization - - - - - -
-
- - -
-
- - -
-
-
-

Your AI Engineering Organization

-

Transforms AI coding agents into a managed engineering team — with a PM that plans, doers that build, and reviewers that verify. On your machines, with your process.

-
- Get Started - View on GitHub -
-
-
- 3 - Agent Roles -
-
- 7 - Fleet Members -
-
- 100% - Your Infrastructure -
-
-
-
-
- -
-
┌─ claude ─────────── project: apra-fleet ─┐
-
-
> /pm status fleet
-
-
🔵 fleet-dev1 (idle)  · local  · windows
-
🟢 fleet-dev2 (idle)  · 192.168.1.13  · macos
-
🟢 fleet-rev1 (idle)  · 192.168.1.13  · macos
-
Fleet v0.1.2  ·  7/7 online
-
-
-
- -
-
┌─ claude ─────────── project: apra-fleet ─┐
-
-
> /pm plan #67
-
-
Planning Sprint 6a…
-
✓ Requirements written
-
✓ Plan generated (7 tasks, 3 phases)
-
✓ Reviewer APPROVED (12/12 checks)
-
Ready for execution.
-
-
-
- -
-
✨ Gemini ─────────── project: apra-fleet ─┐
-
-
> /pm start dev1 plan
-
-
🔵 fleet-dev1: Executing Phase 1…
-
✓ Task 1: Schema + data layer — committed
-
✓ Task 2: UI implementation — committed
-
⏸ VERIFY-1: Tests passing (524/524)
-
Stopped at checkpoint. Awaiting review.
-
-
-
- -
-
✨ Gemini ─────────── project: apra-fleet ─┐
-
-
> /pm deploy dev1
-
-
Deploying to production…
-
✓ Health check: ok
-
✓ Version: 0.2.4
-
✓ Deployed successfully
-
Production: live 🟢
-
-
-
-
-
-
-
- - -
-
-
HOW IT WORKS
-

The Fleet Architecture

-

- Three specialized roles. One unified workflow. Everything through git. -

-
-
-
📋
-

PM (Project Manager)

-

Plans sprints, breaks issues into tasks, assigns work, tracks progress. Uses a premium model for deep reasoning.

-
/pm plan, /pm start, /pm status
-
-
-
🔨
-

Doer (Specialist)

-

Executes implementation plans step by step. Roles include architect, designer, developer, integration test writer, DevOps engineer, and documentation writer.

-
git commit, test, verify
-
-
-
🔍
-

Reviewer (Quality Gate)

-

Reviews every PR against the plan. Blocks merges that miss requirements. Thorough analysis at every checkpoint.

-
review, approve, block
-
-
-
-
- - -
-
-

Why Apra Fleet?

-
-
-
🌐
-

Cross-Platform Fleet

-

Windows, macOS, Linux. Local members + remote via SSH. Mix and match your infrastructure.

-
-
-
🧠
-

Smart Model Routing

-

Route premium models for planning, mid-tier for coding, fast models for status checks. The right tier for each task.

-
-
-
🔀
-

Git as Transport

-

Everything flows through git. No proprietary sync protocol. Standard branches and PRs.

-
-
-
🛡️
-

Crash Recovery

-

/pm recover inspects git state and resumes from last checkpoint. Nothing is lost.

-
-
-
☁️
-

Cloud Compute

-

AWS EC2 auto start/stop. GPU-aware idle detection. Pay only when building.

-
-
-
✅
-

Mandatory Review Gates

-

No reviewer approval = no merge. Every change gets verified against the plan.

-
-
-
-
- - -
-
-

Get Running in 3 Steps

-
-
-
1
-

Download

-

Available for Windows, Ubuntu, and macOS. Download the latest release from GitHub.

-
-
-
2
-

Install & Register

-

Install the executable, then register fleet members — local machines or remote via SSH.

-
-
-
3
-

Start Managing

-

/pm plan to generate a plan, /pm start to build, /pm deploy to ship.

-
-
-
- Download Latest Release -
-
-
- - -
-
-

How Fleet Compares

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CategoryToolsWhat’s MissingApra Fleet
Better AutocompleteCursor, Copilot, Windsurf, ClineOrganization, process, scaleFull engineering org
Autonomous Task RunnerDevin, Codex, OpenHandsYour infrastructure, your processRuns on your machines
Multi-Agent FrameworkCrewAI, AutoGen, LangGraph, MetaGPTWorking system, git workflowsProduction-ready system
AI-Native Engineering OrgApra Fleet—The complete picture
-
-
-
- - -
-
-

Real Stories

-
-
-

The Weekend Rewrite

-

CTO demands auth system migration by Monday. Fleet plans, builds, and ships the rewrite overnight. 3 doers, 2 reviewers, zero humans coding.

-
-
-

The Solo Founder

-

200-item backlog, one person. Ships 5 features per week writing zero code. PM plans each sprint, doers execute, reviewers verify.

-
-
-

The 3am Recovery

-

Production PM crashes mid-sprint. /pm recover inspects git state, finds last checkpoint, resumes all in-flight work. Nothing lost.

-
-
-
-
- - - - - - - -