Piaf Documentation

Crate Architecture

Mapping of the main crates in the Piaf workspace.

Application Entry Point

  • piaf: main desktop binary.
  • piaf-app: application state and workspace + UI composition.

Agent Domain

  • piaf-agent: provider types and traits.
  • piaf-acp: agent session infrastructure.
  • piaf-claude: Claude connector.
  • piaf-codex: Codex connector.
  • piaf-opencode: OpenCode connector.

Git / GitHub Domain

  • piaf-git: local git operations.
  • piaf-github: GitHub CLI (gh) integration.
  • piaf-ui-review: review panel and PR flows.

Workspace / Project

  • piaf-project: project/folder lifecycle.
  • piaf-workspace: workspace and worktree lifecycle.
  • piaf-storage: config/history/cache persistence.

UI

  • piaf-ui-chat, piaf-ui-pane, piaf-ui-core, piaf-ui-kit
  • piaf-ui-diff, piaf-ui-terminal, piaf-ui-file-tree
  • piaf-ui-permissions, piaf-ui-tools, piaf-ui-input

Collaboration / Infrastructure

  • piaf-collab, piaf-crdt, piaf-connectivity
  • piaf-terminal, piaf-search, piaf-opener, piaf-notifications
  • piaf-speech, piaf-power, piaf-sandbox, piaf-updates

On this page