Polystro logoPolystro
FeaturesPricingDocsCompare
Log inSign up

Docs

Desktop product docs, organized as a docs tree instead of a marketing page.

Need full docs search? Use Cmd+K or Ctrl+K.

Getting Started

Overview

Installation

CLI Setup and Auth

Core Concepts

Workstreams and Isolation

Browser and Services

Worktree Modes

Workflows

Agent Workflows

Sessions and Layout

Planning and Ideation

Review and Merge

Search and Shortcuts

Imported History and Project Actions

Operations

Services and Previews

Environment and Routing

Automation and Remote Access

Scripts vs Automations

Command Routing and Slash Commands

Local Viewer

Settings and Integrations

Updates, Licensing, and Support

Troubleshooting Index

Permissions and Safety

HomeDocsOperationsPermissions and Safety
Operations

Fast local agent work still needs clear safety boundaries.

Polystro is designed for a local desktop environment, but that does not mean every action should run silently. Permission modes, local-only services, runtime scoping, and URL restrictions are part of how the app stays practical without becoming reckless.

Permission Modes

Sessions can run in supervised mode or, where supported, a looser skip-permissions style mode. Supervised mode exists for the moments where the agent needs confirmation before continuing.

Supervised mode

Prompt for approval when the session reaches a gated action instead of letting it continue silently.

Inline resolution

Permission requests appear in the session flow so you can answer without losing context.

Per-session control

Permission mode is chosen in the session context rather than being a one-time global toggle only.

Fail-closed bias

The product favors explicit denial on timeout or loss of the relevant session context rather than assuming approval.

Prompt and Response Flow

The agent flow is normalized so permission requests and user questions can stay visible in the transcript. That lets the desktop shell act as the coordination point instead of forcing every interruption into a separate out-of-band tool.

Desktop Boundaries

Polystro is deliberately scoped to the local machine and known workstream roots. Filesystem access is repo-aware, external URL opening is restricted, and local runtime surfaces are built around the desktop host rather than around arbitrary public exposure.

What users should understand

The app is powerful because it runs on your machine near your repos and services. The safety model is about keeping that power legible and bounded, not about pretending the desktop host is a generic cloud sandbox.

Why This Is Local-First

The deeper theme is that Polystro is local-first. Routes, terminals, worktrees, services, and viewer sessions all originate from the desktop runtime. Permission and safety features make that local-first model usable for real parallel agent work without turning the app into a black box.

Previous

Troubleshooting Index

Start from the symptom and route yourself to the right Polystro surface instead of debugging the wrong layer.

On This Page

Permission ModesPrompt and Response FlowDesktop BoundariesWhy This Is Local-First
Polystro logoPolystro

The desktop app for running parallel agents without port, browser, or git collisions.

Product

  • Features
  • Pricing

Resources

  • Docs
  • Compare

Company

  • Privacy
  • Terms

© 2026 Polystro. All rights reserved.

Built for multi-agent software development on desktop.