Skip to content
PerficaPerfica docs

Introduction

Perfica is a desktop app for Windows, macOS and Linux. You describe an app, and loops of AI agents plan it, build it, review it and test it in a folder on your own computer. When a run runs out of work, Perfica writes a finish report, and the Report tab can run the app in a live preview.

The name comes from the Latin perficere, to finish.

The words Perfica uses

Section titled “The words Perfica uses”
Word What it means
Bubble One agent with one role: Architect, Designer, Coder, Reviewer, Tester, Fixer and others. Each time a bubble runs is one pass.
Loop (or ring) A closed chain of bubbles. Each bubble’s output is the next one’s input, and the loop keeps turning while there is work.
Sub-loop A loop hanging off a Subloop bubble on a main loop. When the bubble before it fails, the main loop waits while the Sub-loop runs, then carries on. It sits beside its loop and turns the other way.
Board One project: its loops, its Task Book, its project brief and, usually, a folder on disk.
Task Book The board’s cards: Draft, Approved, Implementing, Review, Done and Blocked. Loops only take Approved work.
Manager The chat you plan with. It has four modes: Ask, Plan, Code and Build.
Finish report What a completed run leaves in the Manager’s Report tab: what was built, how to run it, what was tested and what’s missing, beside a Live preview of the app.

Where to start

Section titled “Where to start”