Releases: first-tree-ai/first-tree
Releases · first-tree-ai/first-tree
Release list
v0.5.22 — New runtime providers, safer Team Skills, clearer installs
Highlights
- Supports Amp and DeepSeek Harness as first-class runtime providers, with safer authentication and binary-detection paths.
- Makes configured Team Skills discoverable in the slash-command menu, including mention-prefixed commands in group chats, while keeping invocation safe across local naming conflicts.
- Adds an experimental meeting-to-tree skill and clearer progress, timing, and service-readiness feedback in the portable and development installers.
Notable fixes
- Improves Claude credential recovery and Codex binary fallback when configured executables cannot be used.
- Surfaces blocked or stale in-flight runs as recoverable attention and clears stale working state when sessions stop.
- Preserves mobile chat-list position and excludes hidden Skills from public copy counts.
Compatibility
github followandgithub unfollowno longer accept commit references. Commit-comment activity continues to route automatically through GitHub webhooks.
v0.5.21 — Feishu Agent channels, simpler setup, local Context
Highlights
- Connect Team Agents to Feishu through the new optional Agent Channel. The single-page OpenTag flow creates or selects an Agent, registers its bot, prepares local Feishu tooling, and supports DMs, exact group mentions, direct replies, activated threads, reactions, attachments, and bounded conversation context.
- Create and manage Team Agents with a shorter flow: team-visible defaults, responsibility provenance in Profile, restored Member Workspace and Team access, clearer GitHub Task Agent eligibility, and a direct Add to Feishu handoff.
- Managed Agents whose Team has no bound shared Context Tree can now use an Agent-local Context Tree fallback while valid Team bindings remain authoritative.
- Cursor users can select the Router's Auto · Intelligence, Auto · Balance, and Auto · Cost modes directly in runtime settings.
Notable fixes
- macOS managed updates keep the launchd wrapper online across CLI replacement and report stopped services accurately.
- Inbox acknowledgements no longer confirm deliveries outside the current socket's admitted prefix, and timeout recovery now converges safely after rebind.
- Missing optional integrations degrade only the dependent operation, Grok Build 1.x is accepted, and member Workspace/Team navigation is restored.
- OpenTag onboarding now completes only at a usable Feishu handoff and remains stable on narrower desktop layouts.
Operations and compatibility
- Existing Feishu bots must explicitly reauthorize through the visible QR flow to grant the new group-message permission; the current connection remains usable until replacement authorization succeeds.
- Attachment-retention deletion remains disabled unless
FIRST_TREE_ATTACHMENT_RETENTION_DELETE_ENABLED=true. When enabled, eligible message attachments older than 14 days are permanently removed unless protected by a Team Skill Resource or Agent Template bundle. - Clients older than
v0.5.12are unsupported. Deploy Web and Server from the same Docker image.
v0.5.20 — Context influence, easier agent control, private-deployment SSO
Highlights
- See where Context Tree guidance changed agent work: the Context tab now surfaces agent-reported influence, ranks cited nodes, and lets you filter the activity feed to influence events.
- Create and manage agents with less navigation: choose an online computer and runtime in one flow, switch agents from the Agent Detail breadcrumb, and remove other speakers from a chat from their identity card.
- Private deployments can require OpenID Connect SSO with PKCE, discovery/JWKS validation, and provider-aware login UI.
Notable fixes
- BYO Context workflows now preserve the exact installed CLI channel and pass the local GitHub identity through write-worktree setup, avoiding channel mismatch and authorization failures.
- Client recovery quarantines timed-out suspend handlers instead of letting stuck provider callbacks block future work, while SCM follow authority is more stable.
- Markdown rendering keeps a stable default renderer, and Chat Summary lead lines no longer receive unintended bold styling.
Compatibility
- Clients older than
v0.5.12are no longer supported. Upgrade older computers before using this release. - Web and Server now assume same-version deployment; deploy them from the same Docker image.
v0.5.19 — Agent Templates, more runtimes, visible Context impact
Highlights
- Discover and adopt official Agent Templates that bring curated instructions, Skills, MCP integrations, and starter responsibilities into new or existing agents.
- Choose from three additional agent runtimes—OpenCode, Grok Build, and Pi—with provider-aware setup, session handling, and recovery.
- Use BYO Context in the current session and across multiple Teams, with scoped routing, exact apply commands, and visible notes showing how Context Tree decisions influenced an answer.
- Let repository-scoped task agents automatically handle supported GitHub Issue and pull-request activity without requiring mentions or assignments.
- Move through a smoother first-chat Orientation, clearer Agent Details, and a Need you queue that resolves requests inside their original chats.
Notable fixes
- Preserved portable-install identity and tightened managed/BYO Context handoffs so sessions stay on the intended Team and channel.
- Kept Kimi background work alive through turn completion and fixed bundled SDK paths in npm packages.
- Avoided automatic provider discovery in macOS protected folders and hardened runtime session recovery and cleanup.
- Improved Chat Summary hierarchy and reading width, composer mentions, working-turn timers, and chat token-usage performance.
v0.5.18 — BYO Context, GitHub task agents, complete Team Skills
Highlights
- Bring Team Context into Claude Code and Codex with provider-project and pathless activation, self-verifying setup, immediate in-session adoption, and a dedicated Context Tree settings page.
- Delegate GitHub Issue and pull-request tasks to a repository-scoped Team Agent, with terminal replies published by the First Tree GitHub App.
- Distribute complete Team Skill bundles—including nested references, scripts, and binary assets—across supported agent runtimes.
- Review open agent questions through the desktop and mobile Need you queue, ask for clarification without resolving the request, and process requests sequentially.
- Select Codex Fast mode and inject First Tree-managed MCP servers into Cursor and Kimi Code.
- Give invited members a progressive, personal-agent-first onboarding path and make the mobile PWA easier to install from desktop or phone.
Notable fixes
- Improved GitLab project-hook routing and clarified Context Reviewer and private-project setup states.
- Kept chat navigation, the composer, pinned selection, and Mobile Work responsive under background activity.
- Strengthened daemon ownership, runtime token recovery, resumed-message custody, tracked-request images, and attachment persistence.
- Run the production container as a non-root user.
Upgrade note
Existing First Tree GitHub App installations must re-approve the upgraded Issues: write permission before App-authored terminal replies can be published. Other GitHub automation continues to work while this permission is pending.
v0.5.17 — Unified Work, scheduled jobs, and guided Setup
Highlights
- Mobile now has one unified Work surface for attention, unread, pinned, active, archived, and watched conversations, with fuller summaries and inline current state.
- Scheduled jobs are now first-class: agents can create and manage recurring work through the CLI, while Desktop shows schedule status, upcoming runs, and owner lifecycle controls.
- Settings → Setup now centralizes Team readiness and owner actions for repository automation, Context Tree, and Automatic Review, including guided GitLab System Hook setup with real merge-request routing verification.
- Context Tree workflows now support GitLab repositories, while review flows gain repair-first handling, stronger final-tree checks, and exact decision-influence receipts.
- The composer now exposes a focused live activity inspector so users can understand active agent work and jump to its timeline evidence.
Notable fixes
- New human input can retry Codex steering after an earlier append rejection instead of waiting for a long-running turn to finish.
- Failed managed-agent chats remain in Attention while offline and through reconnects until they genuinely recover.
- Mobile selection, sent mention rendering, GitLab entity links, and Context Review topic/merge behavior are more reliable.
v0.5.16 — GitLab attention, Kimi runtime, Context review and audit
Highlights
- Add Kimi Code as a first-class agent runtime provider, including capability detection, configuration surfaces, and runtime handling.
- Bring GitLab entity attention alongside GitHub with
follow,following, andunfollowCLI commands, connection and identity settings, webhook routing, and native chat cards. - Ship dedicated Context Tree review and audit skills together with the reusable First Tree QA workflow and cases.
- Add connected Google and GitHub account management plus an install-free quick start for invited team-agent users.
Notable fixes
- Retry transient provider failures even after visible output and report Claude token usage as accurate deltas.
- Align SCM attention semantics, make repository settings provider-neutral, keep renamed chat titles in sync, and improve participant and people-picker interactions.
- Harden OAuth cookie and credential handling while completing landing-campaign conversion measurement and restoring onboarding and growth analytics delivery.
v0.5.15 — Stable agent briefings and focused mobile chat cards
Highlights
- Keep the full agent briefing checked in and session-stable across runtimes, with compact GitHub and GitLab guidance available without per-session capability drift.
Notable fixes
- Preserve correct GitHub issue and pull-request routing while simplifying GitLab operations around native
glabguidance instead of a bundled GitLab skill. - Restore mobile Chat to compact conversation rows and remove unintended management gestures and controls from mobile Now and Chat cards that could stretch rows or expose unsupported actions.
v0.5.14 — Production mobile, Cursor runtime, pinned chats, stricter Context Trees
Highlights
- Bring the mobile workspace to production, including add-to-home-screen guidance and touch-first chat, triage, and picker improvements.
- Add the external Cursor Agent CLI as a supported runtime provider, with in-product setup, session resume, authentication handling, and replay-safe failure recovery.
- Prioritize conversations with attention and private pinned groups, activity-based ordering, richer filters, and cross-device pin synchronization.
- Let agents send workspace images through
chat send, with improved image sizing, galleries, and a full-screen lightbox. - Add agent-scoped Context Tree bindings, generated governance guidance, and stronger GitHub/GitLab forge setup workflows.
Notable fixes
- Install Linux daemon services in system scope when the CLI runs as root, while preserving user-scoped systemd behavior for normal users.
- Route user-requested issues and pull requests to the repository the work belongs to instead of accidentally defaulting to First Tree's tracker.
- Improve iOS standalone sizing, mobile card previews, install-guide copy, and narrow-screen timeline layouts.
Compatibility
- Context Tree validation is now strict and always on. Trees with malformed metadata, unsafe symlinks, invalid
soft_links, or cross-content-class links must be repaired before their next tree PR can pass.
v0.5.13 — Windows daemon support, file attachments, chat-first Context setup
Highlights
- Run First Tree agents on Windows through a per-user Task Scheduler daemon supervisor, with service restart/recovery hardening and reliable npm/Codex executable resolution.
- Attach documents and other files from existing chats, new-chat drafts, and request answers; agent runtimes can download non-image attachments for Claude and Codex handoff.
- Start or recover Context Tree setup in a private chat, resolving sources from declared workspace repositories, a local Git repository, or a GitHub URL.
- Use GPT-5.6 Sol, Terra, and Luna Codex models with
maxandultrareasoning, and discover the Codex CLI bundled with the ChatGPT desktop app. - Hosted macOS/Linux onboarding now uses the channel-aware portable installer with simpler copyable install and login commands.
Notable fixes
- Surface terminal provider failures as durable, actionable chat notices, including clearer Claude proxy and connectivity guidance.
- Resolve runtime-session tokens fresh from per-agent files and tolerate token-rotation races during soft enforcement.
- Make
first-tree upgradefall back to the current channel's latest release when no server URL is configured. - Let self-directed GitHub assignments and mentions create a tracking chat when none exists.
- Reject malformed double-escaped agent messages while preserving intentional stdin and message-file bodies.
- Correct CommonMark fence handling in document-link previews to avoid missed or spurious links.
- Reduce generated agent briefing size while preserving the hard collaboration, worktree, Context Tree, and skill rules.
Compatibility notes
- Windows daemon support is per-user and starts after sign-in through Task Scheduler; it is not a Windows Service or pre-login daemon.
- The new mobile
/m/*shell remains channel-gated and disabled in production. - Existing npm-installed clients keep upgrade compatibility; hosted fresh installs on macOS/Linux use the portable installer.