Cloud Sync

End-to-End Task Sync

Understand how tasks flow between Paean CLI and Paean App, enabling seamless collaboration between your terminal and all your devices.

How It Works

When you create or complete tasks via CLI, they automatically sync to the Paean Cloud. These tasks appear in your Paean App workspace and can be managed from any device.


  ┌──────────────┐          ┌──────────────┐          ┌──────────────┐
  │  Paean CLI   │  ──────► │ Paean Cloud  │ ◄──────  │  Paean App   │
  │  (Terminal)  │          │  (Backend)   │          │ (Web/Mobile) │
  └──────────────┘          └──────────────┘          └──────────────┘
        │                          │                         │
        │    Create Task           │                         │
        │ ─────────────────────►   │                         │
        │                          │   Real-time Push        │
        │                          │ ─────────────────────►  │
        │                          │                         │
        │                          │   Complete Task         │
        │   Sync Status            │ ◄─────────────────────  │
        │ ◄─────────────────────   │                         │
        │                          │                         │
                

Task System

Tasks are the core unit of work in Paean. They can be created from anywhere and are automatically assigned to available workers.

Create Tasks via CLI

# Quick task creation
$ paean prompt "Fix the login validation bug"
# Task appears in Paean App instantly

Task Lifecycle

PendingTask created, waiting for worker
AssignedWorker picked up the task
RunningTask is being executed
VerifyingPost-execution validation
CompletedTask finished successfully

Real-time Sync

Changes sync bidirectionally in real-time. Complete a task in the app, and your CLI worker knows immediately.

CLI → Cloud

  • • Task creation & completion
  • • Execution logs & traces
  • • Worker heartbeat status
  • • Conversation history

App → Cloud

  • • Manual task creation
  • • Priority adjustments
  • • Task cancellation
  • • Moment captures

Common Workflows

🏠 Work from anywhere

Create a task on mobile while commuting, let your CLI worker execute it at home.

Mobile: Create "Refactor auth module" → Home CLI: Auto-executes

🔄 Continuous Development

Run the worker 24/7 to process tasks even when you're away.

$ paean worker start → Polls and executes tasks continuously

📊 Full Visibility

Track all execution traces and token usage from the Paean App dashboard.

App Dashboard → View task history, costs, and performance

Next Steps