Nyaraka
Mtiririko wa kazi
Mchakato wa kazi, matukio, modi, utatuzi wa matatizo, na kamusi.
Workflows & reference
Working process
Each session, in this order. The agent writes the board, Desktop watches it, Desktop syncs to Cloud — so start those pieces in the same order.
- Launch the local desktop app — Desktop is the watcher and the sync client. Confirm the project is watched and the watcher is on before the agent writes.
- Launch or open your IDE — work happens here. Open the same repo Desktop is watching; the agent updates that repo’s board. Peacae does not replace the IDE.
- Connect with Cloud for sync — optional. Sign in, link that folder to one cloud project, leave sync on. Skip this for solo or offline work; teammates will not see the board until you connect.
If you open the IDE first, the agent can still write — you just will not see a live Peacae board until Desktop is running. See How it works.
Common scenarios
| Scenario | Steps |
|---|---|
| Start a session | Launch Desktop → open your IDE → connect Cloud for sync |
| Solo, local | Project setup in repo → Desktop watches → agent follows instructions → no account |
| Team sync | Everyone signs in → same cloud project → auto-sync on |
| Blocked | Agent sets blocked_at + short notes → you unblock → agent sets started_at again |
| Offline | Agent keeps updating the board → sync catches up when online |
| New teammate | Invite → accept → point Desktop at the project → link project |
| Two products | Add both under Watched projects — focus one for the board; don’t mix codebases onto one board |
| Cross-repo agent work | Task on the current board naming the other path + real tasks in the other project’s setup when possible |
Modes
| Mode | Account | Shared team view |
|---|---|---|
| Local only | No | No |
| Cloud sync | Yes | Yes (Cloud dashboard; org activity across projects) |
Agent write target is always that repo’s project board. Desktop can watch many repos at once.
Troubleshooting
| Symptom | Check |
|---|---|
| Board empty | Watched path, focus, watcher, agent writing features |
| Board not updating live | Desktop launched? Watcher on? Same repo as the IDE? |
| Agent not updating | Prompt to follow the agent instructions in the right repo |
| Sync stuck / failed | Sign-in, that folder’s project link, network |
| Teammate can’t see work | Invite + same linked project; Cloud connected (step 3) |
| Status looks wrong | Latest *_at timestamp; don’t clear history |
Glossary
| Term | Meaning |
|---|---|
| Agent instructions | Agent contract for planning, status, and scope |
| Feature / Task | Planned group / executable unit |
| Titles / notes | Short board signals only — not full chat, PRs, or logs (see data model) |
| Scope | Allowed agent actions in project preferences |
| Watched projects | Desktop list of project paths (multi-project) |
| Working process | Daily session order: launch Desktop (watch) → open your IDE (agent writes) → connect Cloud (optional sync) |
| local_id / cloud_id | Local identity / cloud mapping after sync |