apra-fleet Files

What's New

Features

Multi-provider support — Gemini (well tested), Codex (to be tested) and Copilot (to be tested) members are now first-class citizens alongside Claude. A ProviderAdapter interface handles all provider differences internally — PM and fleet skills are fully provider-neutral. (#38)

Member name resolution — All tools now accept member_name as an alternative to member_id. No more UUID lookups for routine operations. (#51)

receive_files tool — Download files from a member's work folder to a local directory. Mirrors send_files — batch transfers in a single call, work_folder boundary enforced. (#65)

Model tier abstraction — execute_prompt now accepts cheap, standard, or premium instead of specific model names. The server resolves tiers to the correct model per provider. Task plans carry tier assignments that PM reads at dispatch time. (#53)

Fleet / PM skill split — Fleet skill now owns all infrastructure mechanics (member management, permissions, dispatch, auth). PM skill owns orchestration only — no infrastructure details bleed across. Skills can be updated independently. (#66, [#82])

DRY OAuth for all providers — provision_auth and remove_member are fully provider-generic via ProviderAdapter. Gemini OAuth deploys 3 credential files and deep-merges settings. Claude, Codex, and Copilot handled without provider-specific branches. (#62)

Prompt delivery via file — Prompts are written to a .fleet-task-<uuid>.md file and passed by reference to the LLM CLI. Eliminates Windows shell quoting bugs that affected Gemini members. (#65)

Server version surfaced — fleet_status(format="json") and all JSON-format tool outputs include server_version. (#50)

PM skill improvements — Sprint selection gate (simple / single-pair / multi-pair), pre-flight checks before every dispatch, documentation harvest before cleanup, backlog IDs (BL-N), and reviewer SHA verification. (#82)

OOB API key entry — Non-Claude providers that require an API key during auth can now enter it interactively via an out-of-band prompt during provision_llm_auth. (#40)

Bug Fixes

• Windows VCS auth — Credential helper now uses a host-specific git config key to avoid conflicts with gh CLI credential management. Batch metacharacter escaping fixed. (#14)
• Gemini session resume — Sentinel sessionId no longer used; actual session IDs are captured and passed correctly on resume. (#40)
• Session ID sanitization — Parity fix between providers; DRY session handling extracted to shared utility.
• macOS env var persistence — .zshenv now included in setEnv/unsetEnv so variables survive non-interactive sessions. (#40)
• remove_member — SSH key deletion now skipped when the key is shared with another member. (#65)
• send_files / receive_files — Null-byte rejection added to file path inputs.
• Shell path escaping — $HOME now expands correctly in all remote shell commands via shellPath helper. (#65)
• env var validation — apiKeyCheck and non-Claude provider verification now validate env var names to prevent injection. (#44, [#47])
• UX, quality & installer fixes — (#6, [#9], [#10], [#37], [#39], [#42], [#57], [#67], [#78], [#80], [#81])

Renames / Removals

• update_agent_cli → update_llm_cli — provider-neutral naming. Old alias removed.
• reset_session removed — redundant with execute_prompt(resume=false).
• cloud_ssh_key_path consolidated into key_path.

Notes

• OOB terminial does not allow pasting (#42)
• Members registered before v0.1.3 continue to work — all changes are backward-compatible.
• Gemini premium tier now maps to gemini-2.5-pro-preview.
• .fleet-task*.md files are now added to member .gitignore but will need to be cleaned up (next sprint)

What's Changed

• Add GitHub Pages product site for apra-fleet by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/19
• Fix PM skill: doer-reviewer flow, templates, safeguards, cleanup (#29 [#28] [#18] [#2]) by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/30
• fix(#31): cleanup fleet control files before merge, not after by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/32
• Fix Windows VCS auth: PowerShell syntax + token expiry tracking by @joiskash in https://github.com/Apra-Labs/apra-fleet/pull/14
• Multi-provider support: Claude, Gemini, Codex, Copilot by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/38
• feat: token usage improvements — default model tier, token extraction, update_task_tokens tool by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/49
• feat: member name resolution, receive_files, DRY OAuth, and provider-neutral tool descriptions by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/65
• UX, quality & installer fixes (issues [#6], [#9], [#10], [#37], [#39], [#42], [#57], [#67], [#78]) by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/79
• Refactor: split fleet skill out of PM skill (#66) by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/82

Full Changelog: https://github.com/Apra-Labs/apra-fleet/compare/v0.1.2...v0.1.3