# Unpeel

Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. The same evidence rules apply to Podium and its competitors, but they do not remove this conflict of interest.

Page: https://adecomparison.com/ade/unpeel/
Website: https://unpeel.com/
Research: covered

Method: https://adecomparison.com/method/

Rank by must-haves met, then preferences, then name. Read each finding's checked date. Findings stay published after their scheduled recheck. Checks over six months old may be outdated.

## unpeel:ACC-01

Finding: Unpeel ships a native Apple-Silicon Mac GUI, iPhone/iPad clients and a native macOS/Linux CLI. The CLI rejects Windows. Android is absent from the complete current client list and the web client is explicitly later.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/README.md
Locator: Clients; Open source boundary
Finding: Pinned README says server and Apple client sources are included, local/direct use is free, and only operated Link backend is closed.
Retrieved: 2026-11-07

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/scripts/install.sh#L30-L44
Locator: scripts/install.sh platform switch; README clients; docs How Unpeel runs
Finding: The native CLI installer supports macOS and Linux and explicitly rejects other OSes. The shipped clients are Mac, iPhone/iPad and CLI; the web app is explicitly later, with no native Android build. CLI access is separate from a Linux GUI.
Retrieved: 2026-11-13

## unpeel:ACC-02

Finding: CLI runtime integration is provider- and launch-specific. Unpeel v0.7.6 includes a built-in Antigravity runtime, agy launch preset, native resume capability and MCP configuration.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version:  Antigravity source pass: v0.7.6 (ce8ce94b64c88dadf56ef3c10f2118a3f034972d).

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.
The Antigravity runtime is scoped to macOS/Linux. Its output-based status is not marked reliable for completion or attention.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents
Locator: Agent matrix; MCP support
Finding: Named CLI runtime launch, hooks, transcript and resume support differ; Pi uses output heuristics and MCP support is provider-specific.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agent-runtimes
Locator: Managed vs observed
Finding: Managed launches bind provider conversation identity; merely observing a CLI in a blank terminal does not grant safe resume or transcript access.
Retrieved: 2026-11-07

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/runtimes/antigravity/runtime.toml#L1-L49
Locator: runtimes/antigravity/runtime.toml lines 1-49, v0.7.6, commit ce8ce94b64c88dadf56ef3c10f2118a3f034972d
Finding: Unpeel v0.7.6 includes a built-in Antigravity runtime, agy launch preset, native resume capability and MCP configuration.
Retrieved: 2026-11-10

## unpeel:ACC-03

Finding: Users bring provider logins and API keys.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents
Locator: Agent matrix; MCP support
Finding: Named CLI runtime launch, hooks, transcript and resume support differ; Pi uses output heuristics and MCP support is provider-specific.
Retrieved: 2026-11-07

## unpeel:ACC-04

Finding: App setup bundles server; headless hosts have a supported installer.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/headless-host
Locator: Shipping status; Setup; Host requirements
Finding: Same server runs on an owned Mac/Linux host with service-manager setup and phone/Mac clients; full cloud-machine matrix remains under validation.
Retrieved: 2026-11-07

## unpeel:ACC-05

Finding: CLI and session-scoped MCP expose actual operations.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

## unpeel:ACC-06

Finding: Built-in MCP and optional Plugins expose tools with per-session grants.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/agent-runtimes
Locator: Managed vs observed
Finding: Managed launches bind provider conversation identity; merely observing a CLI in a blank terminal does not grant safe resume or transcript access.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/worktrees
Locator: Experimental; Creating
Finding: Optional worktrees are off by default and create child projects; agent worktree preparation requires an additional grant.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-apps
Locator: Plugins; Placement; Open policy
Finding: Standalone terminal plugins can be surfaced as sessions/companions; widget rail is roadmap work, not current UI.
Retrieved: 2026-11-07

## unpeel:ACC-07

Finding: Apple clients use Swift platform packages.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Source statements were checked; no hands-on scenario was run.

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/README.md
Locator: Clients; Open source boundary
Finding: Pinned README says server and Apple client sources are included, local/direct use is free, and only operated Link backend is closed.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/clients/native/UnpeelNative/Package.swift
Locator: Swift package targets and platform dependencies
Finding: Apple client uses a Swift package with platform UI dependencies, linked to the shared Unpeel client/Host components.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/clients/ios/UnpeelIOS/Package.swift
Locator: Swift package targets and platform dependencies
Finding: Apple client uses a Swift package with platform UI dependencies, linked to the shared Unpeel client/Host components.
Retrieved: 2026-11-07

## unpeel:PLAN-01

Finding: Project folders and presets provide session intake.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/projects-and-presets
Locator: Presets; Commands
Finding: Users manage launch presets and project folders; arbitrary commands remain supported.
Retrieved: 2026-11-07

## unpeel:PLAN-04

Finding: Provider transcripts and skill guidance are distinct from managed product memory.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents-mcp
Locator: Actions; Transcript policy
Finding: Recognized runtime occurrences can be listed, read and waited on; stale occurrence references are rejected.
Retrieved: 2026-11-07

## unpeel:PLAN-05

Finding: Browser tools and image attachments provide task context.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/session-gallery
Locator: Sources; Image actions; Limits
Finding: Session gallery shows browser captures/downloads and user images; phone markup/attachment and Host-dependent write parity are documented. Video is not supported yet.
Retrieved: 2026-11-07

## unpeel:PLAN-06

Finding: The scoped Unpeel core persists projects, presets and terminal sessions, without a native issue/backlog entity separate from sessions. Sidebar groups organize sessions rather than issue state.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-core/src/session_host.rs
Locator: session_host.rs launch/process/timer paths; state.rs project/preset/session data; CLI command inventory and crates/apps catalog searched for issue, backlog, container, VM, schedule and PR operations
Finding: The core launches detached PTYs as the Host OS user and stores sessions/projects/presets, with optional Git worktrees. It has no per-agent container/VM provisioning or separate native issue entity. Host timer jobs are runtime observation/heartbeats, not an agent-work scheduler. The CLI explicitly supports script/CI/cron session control.
Retrieved: 2026-11-13

## unpeel:COORD-01

Finding: Multiple live sessions run concurrently.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/worktrees
Locator: Experimental; Creating
Finding: Optional worktrees are off by default and create child projects; agent worktree preparation requires an additional grant.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/activity
Locator: States; Menu bar
Finding: Busy/done/needs-you states use provider hooks or output heuristics with explicit limits; status survives app restart.
Retrieved: 2026-11-07

## unpeel:COORD-02

Finding: Workspace process leases and occurrence checks prevent stale targeting.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents-mcp
Locator: Actions; Transcript policy
Finding: Recognized runtime occurrences can be listed, read and waited on; stale occurrence references are rejected.
Retrieved: 2026-11-07

## unpeel:COORD-03

Finding: In the pinned v0.7.6 core, a session granted Create & remove can create worker sessions, inspect transcripts/state, wait and send instructions through Unpeel MCP. The 0.7.5 release note and implemented permission checks resolve the earlier documentation-parity gap.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

Some current web documentation still says agents cannot create/close sessions. This answer is bounded to the published 0.7.5 change and pinned v0.7.6 implementation with explicit Create & remove permission; no hands-on run was performed.

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions-mcp
Locator: Read/write/lifecycle rules
Finding: Docs describe peer reads and directional write approval, but say agents cannot create/close sessions; this conflicts with newer 0.7.5 release notes.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-core/src/mcp_host.rs#L715-L745
Locator: mcp_host.rs SESSIONS_ACTIONS, AGENTS_ACTIONS and tool_create_session; state.rs McpRole Manage; changelog 0.7.5 Create & remove
Finding: The pinned core exposes create_session, list/inspect peers, read_screen/read_output/read_transcript, waits and send_text/send_keys. A session granted Create & remove, represented by McpRole::Manage, can create workers and communicate with them. Release 0.7.5 introduced this access; the older docs prohibition on agent-created sessions is stale for this implementation.
Retrieved: 2026-11-13

## unpeel:COORD-04

Finding: Unpeel's headless product CLI explicitly supports starting/driving sessions from external CI or cron. It does not supply an internal scheduler; the external caller owns timing and retries.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-cli/src/cli.rs#L1-L5
Locator: cli.rs module documentation and new/send/wait verb implementations
Finding: The public headless command surface explicitly supports agents, CI and cron driving sessions without a UI or desktop app. The new command creates a preset session programmatically and send/wait manage its work. Scheduling/event ownership stays with external cron or CI.
Retrieved: 2026-11-13

## unpeel:COORD-05

Finding: Terminal state and intervention remain visible across clients.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions-mcp
Locator: Read/write/lifecycle rules
Finding: Docs describe peer reads and directional write approval, but say agents cannot create/close sessions; this conflicts with newer 0.7.5 release notes.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions
Locator: Resume; Limits
Finding: Provider conversation resume differs from PTY survival; precise IDs or provider-specific fallbacks are used, and ambiguous process ownership refuses replacement.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/activity
Locator: States; Menu bar
Finding: Busy/done/needs-you states use provider hooks or output heuristics with explicit limits; status survives app restart.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

## unpeel:COORD-06

Finding: Fleet activity groups attention without requiring every transcript.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/activity
Locator: States; Menu bar
Finding: Busy/done/needs-you states use provider hooks or output heuristics with explicit limits; status survives app restart.
Retrieved: 2026-11-07

## unpeel:COORD-07

Finding: Any command can run in a configurable preset.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/projects-and-presets
Locator: Presets; Commands
Finding: Users manage launch presets and project folders; arbitrary commands remain supported.
Retrieved: 2026-11-07

## unpeel:RUN-01

Finding: Owned hosts continue sessions independently of clients.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/headless-host
Locator: Shipping status; Setup; Host requirements
Finding: Same server runs on an owned Mac/Linux host with service-manager setup and phone/Mac clients; full cloud-machine matrix remains under validation.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/workspaces
Locator: Remote; Sharing; Boundaries
Finding: Local, SSH and paired workspaces retain sessions/data on the owning host; additional local workspaces are experimental.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

## unpeel:RUN-02

Finding: Unpeel uses detached Host-user PTYs, separate workspace state and optional worktrees. The scoped core has no product-provisioned per-agent container or VM isolation backend.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/worktrees
Locator: Experimental; Creating
Finding: Optional worktrees are off by default and create child projects; agent worktree preparation requires an additional grant.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-apps
Locator: Plugins; Placement; Open policy
Finding: Standalone terminal plugins can be surfaced as sessions/companions; widget rail is roadmap work, not current UI.
Retrieved: 2026-11-07

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-core/src/session_host.rs
Locator: session_host.rs launch/process/timer paths; state.rs project/preset/session data; CLI command inventory and crates/apps catalog searched for issue, backlog, container, VM, schedule and PR operations
Finding: The core launches detached PTYs as the Host OS user and stores sessions/projects/presets, with optional Git worktrees. It has no per-agent container/VM provisioning or separate native issue entity. Host timer jobs are runtime observation/heartbeats, not an agent-work scheduler. The CLI explicitly supports script/CI/cron session control.
Retrieved: 2026-11-13

## unpeel:RUN-03

Finding: Client/worker recovery differs from process death and stopped-output retention.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions
Locator: Resume; Limits
Finding: Provider conversation resume differs from PTY survival; precise IDs or provider-specific fallbacks are used, and ambiguous process ownership refuses replacement.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

## unpeel:RUN-04

Finding: Host service and browser engine have product-owned setup.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/headless-host
Locator: Shipping status; Setup; Host requirements
Finding: Same server runs on an owned Mac/Linux host with service-manager setup and phone/Mac clients; full cloud-machine matrix remains under validation.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

## unpeel:RUN-05

Finding: Runtime identity checks bound resume operations.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions
Locator: Resume; Limits
Finding: Provider conversation resume differs from PTY survival; precise IDs or provider-specific fallbacks are used, and ambiguous process ownership refuses replacement.
Retrieved: 2026-11-07

## unpeel:RUN-06

Finding: Status authority and retained diagnostic limits are explicit.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/activity
Locator: States; Menu bar
Finding: Busy/done/needs-you states use provider hooks or output heuristics with explicit limits; status survives app restart.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/README.md
Locator: Clients; Open source boundary
Finding: Pinned README says server and Apple client sources are included, local/direct use is free, and only operated Link backend is closed.
Retrieved: 2026-11-07

## unpeel:RUN-07

Finding: Usage plugins are optional external views; billing reconciliation remains unverified.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-apps
Locator: Plugins; Placement; Open policy
Finding: Standalone terminal plugins can be surfaced as sessions/companions; widget rail is roadmap work, not current UI.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/crates/apps/usage/README.md
Locator: Intro; provider list example; quota readings paragraph
Finding: Optional standalone unpeel-usage Plugin reuses local CLI logins to show provider usage: Claude 5-hour/7-day and Grok/Codex weekly allowance percentages used, plus local token totals and per-project tokens. It is not per-task billing.
Retrieved: 2026-11-07

## unpeel:TEAM-01

Finding: Paired clients can enter the same terminal session.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/workspaces
Locator: Remote; Sharing; Boundaries
Finding: Local, SSH and paired workspaces retain sessions/data on the owning host; additional local workspaces are experimental.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

## unpeel:TEAM-02

Finding: Unpeel's core uses paired-client Host access. Agent-session MCP grants are separate from human team roles; the scoped core has no organization/project human role model or enterprise SSO.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-core/src/state.rs
Locator: state.rs McpRole and workspace data; pairing/serve authorization; CLI/App inventory searched for organization roles, SAML, OIDC and SSO
Finding: Human access is paired-client Host access. Read/Write/Create & remove controls apply to agent sessions, not named organization/project human roles. The scoped open-source core has no enterprise SAML/OIDC SSO flow; operated Link account/relay internals are separate.
Retrieved: 2026-11-13

## unpeel:TEAM-03

Finding: Peer writes and device access are scoped and revocable.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/sessions-mcp
Locator: Read/write/lifecycle rules
Finding: Docs describe peer reads and directional write approval, but say agents cannot create/close sessions; this conflicts with newer 0.7.5 release notes.
Retrieved: 2026-11-07

## unpeel:TEAM-04

Finding: Host files and provider transcripts retain inspectable history.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/how-it-works
Locator: Process tree; What survives
Finding: Rust Host owns detached PTY sessions and clients only attach; server/worker restarts can preserve sessions, but machine reboot cannot.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents-mcp
Locator: Actions; Transcript policy
Finding: Recognized runtime occurrences can be listed, read and waited on; stale occurrence references are rejected.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

## unpeel:TEAM-05

Finding: Unpeel's optional first-party Git sidebar App displays proposed working-tree code changes and commit patches in native/terminal renderers. Image-gallery markup remains a separate review path.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://unpeel.com/docs/session-gallery
Locator: Sources; Image actions; Limits
Finding: Session gallery shows browser captures/downloads and user images; phone markup/attachment and Host-dependent write parity are documented. Video is not supported yet.
Retrieved: 2026-11-07

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/apps/diffs/README.md
Locator: Git App README Changes and History; diffs/src/ui.rs; core/apps_mcp.rs default catalog; scripts/apps-link.sh
Finding: The first-party Git App, install slug diffs and binary unpeel-diffs, is registered in the App catalog. It displays staged/unstaged/conflicted/untracked changes and unified code patches, plus commit-history patches, using the same terminal/native App Kit renderer. It supports fetch/pull/push but no pull-request create/manage operation.
Retrieved: 2026-11-13

## unpeel:TEAM-06

Finding: Another paired client can inspect and continue the same session.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/workspaces
Locator: Remote; Sharing; Boundaries
Finding: Local, SSH and paired workspaces retain sessions/data on the owning host; additional local workspaces are experimental.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/agents-mcp
Locator: Actions; Transcript policy
Finding: Recognized runtime occurrences can be listed, read and waited on; stale occurrence references are rejected.
Retrieved: 2026-11-07

## unpeel:SHIP-01

Finding: Per-session image artifacts connect browser output to phone review.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-mcp
Locator: Capabilities; Access
Finding: One session-scoped MCP server provides browser, peer sessions, runtimes, workspace setup and artifacts; grants control visibility and use.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/session-gallery
Locator: Sources; Image actions; Limits
Finding: Session gallery shows browser captures/downloads and user images; phone markup/attachment and Host-dependent write parity are documented. Video is not supported yet.
Retrieved: 2026-11-07

## unpeel:SHIP-03

Finding: Unpeel's optional Git App displays history/diffs and performs fetch, fast-forward pull and push. The scoped App/CLI has no native pull-request creation or management control; agents may use external forge CLIs.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/unpeel-core/src/session_host.rs
Locator: session_host.rs launch/process/timer paths; state.rs project/preset/session data; CLI command inventory and crates/apps catalog searched for issue, backlog, container, VM, schedule and PR operations
Finding: The core launches detached PTYs as the Host OS user and stores sessions/projects/presets, with optional Git worktrees. It has no per-agent container/VM provisioning or separate native issue entity. Host timer jobs are runtime observation/heartbeats, not an agent-work scheduler. The CLI explicitly supports script/CI/cron session control.
Retrieved: 2026-11-13

Source: https://github.com/unpeel-com/unpeel/blob/ce8ce94b64c88dadf56ef3c10f2118a3f034972d/crates/apps/diffs/README.md
Locator: Git App README Changes and History; diffs/src/ui.rs; core/apps_mcp.rs default catalog; scripts/apps-link.sh
Finding: The first-party Git App, install slug diffs and binary unpeel-diffs, is registered in the App catalog. It displays staged/unstaged/conflicted/untracked changes and unified code patches, plus commit-history patches, using the same terminal/native App Kit renderer. It supports fetch/pull/push but no pull-request create/manage operation.
Retrieved: 2026-11-13

## unpeel:OWN-02

Finding: Core local/direct functionality can be hosted without Link.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/cli
Locator: Launch/list; Drive; Lifecycle; Service
Finding: Product CLI creates, inspects, sends, waits and controls sessions; serve install configures a per-user launchd/systemd service.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/headless-host
Locator: Shipping status; Setup; Host requirements
Finding: Same server runs on an owned Mac/Linux host with service-manager setup and phone/Mac clients; full cloud-machine matrix remains under validation.
Retrieved: 2026-11-07

Source: https://raw.githubusercontent.com/unpeel-com/unpeel/e2e0e647a51422683639b858e08cf48b46827c9e/README.md
Locator: Clients; Open source boundary
Finding: Pinned README says server and Apple client sources are included, local/direct use is free, and only operated Link backend is closed.
Retrieved: 2026-11-07

## unpeel:OWN-03

Finding: Host content stays local; relay and notifications have different metadata paths.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

Source: https://unpeel.com/privacy
Locator: Local content; Update counting; Relay
Finding: No behavioral analytics; anonymous update records persist. Terminal UI can disable update checks with UNPEEL_NO_UPDATE. Relay cannot decrypt content; push carries bounded metadata.
Retrieved: 2026-11-07

## unpeel:OWN-04

Finding: Local app is free; optional Link is billed yearly per Host seat. Installed coding agents retain the user's own provider accounts and API keys.

Verification: sourced
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Targeted first-party source check 2026-11-13. New implementation findings are pinned to ce8ce94b64c88dadf56ef3c10f2118a3f034972d. Unchanged atomic answers retain the individual source dates and revisions in their cited evidence.

This source pass establishes only the named atomic answers. Other parts retain their documented source gaps; no hands-on test was performed.

Source: https://unpeel.com/terms
Locator: Free app; Link; License restrictions
Finding: Mac application is free without trial/account/license; Link is $59 per Host seat yearly. Terms prohibit redistribution of modified app builds.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; provider accounts and API keys
Finding: Unpeel launches and manages installed coding-agent CLIs but does not replace their accounts or API keys. The user supplies those credentials and pays the separate agent/provider billing.
Retrieved: 2026-11-13

## unpeel:OWN-05

Finding: Costs separate free local software from optional service and agent usage.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/terms
Locator: Free app; Link; License restrictions
Finding: Mac application is free without trial/account/license; Link is $59 per Host seat yearly. Terms prohibit redistribution of modified app builds.
Retrieved: 2026-11-07

## unpeel:OWN-06

Finding: A dated release and contact support are available.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/terms
Locator: Free app; Link; License restrictions
Finding: Mac application is free without trial/account/license; Link is $59 per Host seat yearly. Terms prohibit redistribution of modified app builds.
Retrieved: 2026-11-07

Source: https://unpeel.com/changelog
Locator: 0.7.5, 2026-10-14
Finding: 0.7.5 removes archive/restore and old stopped scrollback, adds session-scoped Read/Write/Create & remove grants and OSC status reporting.
Retrieved: 2026-11-07

## unpeel:OWN-08

Finding: Local application and direct pairing are free.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/docs/getting-started
Locator: Requirements; First session
Finding: Free Apple-Silicon Mac client bundles server. Projects can be any folder; provider CLI accounts are separate.
Retrieved: 2026-11-07

Source: https://unpeel.com/docs/unpeel-link
Locator: Security; Setup
Finding: Link is optional operated encrypted relay and push; service does not store session content and host must remain reachable.
Retrieved: 2026-11-07

Source: https://unpeel.com/terms
Locator: Free app; Link; License restrictions
Finding: Mac application is free without trial/account/license; Link is $59 per Host seat yearly. Terms prohibit redistribution of modified app builds.
Retrieved: 2026-11-07

## unpeel:OWN-09

Finding: Optional service price and cancellation are public.

Verification: agent-cross-checked
Checked: 2026-11-07
Scheduled recheck: 2026-11-21
Plan: Not specified
Surface: mac; ios; headless-host
Version: Not specified

Documentation establishes only the named atomic answers; remaining questions and hands-on behavior are unverified.

Source: https://unpeel.com/terms
Locator: Free app; Link; License restrictions
Finding: Mac application is free without trial/account/license; Link is $59 per Host seat yearly. Terms prohibit redistribution of modified app builds.
Retrieved: 2026-11-07