How It Works

Peacae turns Git commits into tasks automatically. Commit code with special tags, and tasks are created and updated automatically—no manual work required.

Documentation

Core Concept

Peacae transforms your Git commits into tasks automatically. Simply add @wemp_* tags to your commit messages, and Peacae reads your Git repositories, extracts the tags, determines task status, and stores everything in PostgreSQL. View everything in real-time dashboards—see all completed work, track progress, and manage your projects without breaking your flow.

1

1. Commit with Wemp Tags

Add @wemp_start, @wemp_progress, or @wemp_end tags to your commit messages. Code with AI assistants (Cursor, Copilot) or traditionally. Peacae reads your Git commits and extracts the tags automatically.

  • Add @wemp_start [id/title] to start a new task or update existing to in-progress
  • Use @wemp_progress [id/title] to update an existing task to in-progress
  • Use @wemp_end [id/title] to mark a task as done
  • Link tasks to features with @wemp_feature [name/id]
  • Works with AI assistants or traditional development workflows
2

2. Automatic Scanning & Parsing

Peacae automatically scans your Git repositories (every 12 hours) or you can trigger manual scans. The parser extracts @wemp_* tags, determines task status, and identifies task IDs or titles from commit messages.

  • Automatic background scanning every 12 hours (configurable)
  • Manual scans via UI or API endpoint
  • Parser extracts @wemp_* tags from commit messages
  • Determines task status from tags (@wemp_start = in-progress, @wemp_end = done)
  • Identifies task IDs (short_id) or titles from commit messages
  • Tracks processed commits to prevent duplicates
3

3. Tasks Created & Displayed

Tasks are automatically created or updated based on tags, linked to features, and stored in PostgreSQL. View everything in real-time dashboards—see all completed work, track progress, and manage your projects without breaking your flow.

  • Tasks created automatically from @wemp_start tags
  • Tasks updated from @wemp_progress or @wemp_end tags
  • Tasks linked to features via @wemp_feature tags
  • Everything stored in PostgreSQL database
  • Real-time dashboards show all tasks and progress
  • View completed work, track progress, manage projects
4

4. Feature Linking

Use @wemp_feature tags to link tasks to features automatically. Features group related tasks together, track overall progress, and update activity status when work is being done. One feature can have many tasks.

  • Link tasks to features with @wemp_feature [name/id]
  • Features group related tasks together
  • Track overall feature progress from task completion
  • Feature activity status updates automatically
  • One feature can have many tasks
  • Features provide organization and grouping
5

5. AI Agent Integration

AI agents (like Cursor) can query the API before committing, determine if tasks are new or updates, and generate appropriate tags automatically. Store task IDs locally for quick access and ask users for satisfaction before completing tasks.

  • AI agents query API before committing to find existing tasks
  • Determine if task is NEW (create) or UPDATE (existing)
  • Generate appropriate tags automatically based on intent
  • Store task IDs locally in .wemp/current-tasks.json
  • Ask users for satisfaction before completing tasks
  • Support for natural language intent detection
6

6. Real-Time Updates

Manual scans via UI or API, plus automatic background scanning every 12 hours (configurable). All changes sync immediately—tasks, features, and progress update in real-time across your dashboard.

  • Manual scans via UI or API endpoint (/api/commits/sync)
  • Automatic background scanning every 12 hours
  • All changes sync immediately to dashboard
  • Tasks, features, and progress update in real-time
  • No workflow interruption—just commit code normally

Example Workflow

Here's a complete example of how to use Peacae tags in your commit messages:

bash
git commit -m "feat: Add user authentication\n\nImplement login functionality with OAuth support.\n\n@wemp_start user-auth-001 Add user authentication\n@wemp_feature user-auth"

System Architecture

Peacae consists of several key components that work together:

Git Service

Reads commits from local Git repositories, validates repositories, and tracks processed commits to prevent duplicates.

Wemp Tag Parser

Extracts @wemp_* tags from commit messages, determines task status from tags, and identifies task IDs vs titles.

Task Matcher

Finds existing tasks by ID or title, creates/links features, and handles fuzzy matching.

Commit Task Processor

Orchestrates task creation/updates, links tasks to features, and manages task lifecycle.

Polling Service

Automatically scans projects periodically, handles first-time full scans, and manages service lifecycle.

PostgreSQL Database

Stores all tasks, features, commit history (obfuscated hashes), and activity timeline.

Key Benefits

Zero manual work: tasks created automatically from commits
Full traceability: see which commits created which tasks
Natural workflow: just commit code normally
AI-friendly: works seamlessly with AI coding assistants
Team visibility: everyone sees progress automatically
No workflow changes: works with existing Git practices
Real-time updates: see progress as it happens
Feature organization: group related tasks together

Ready to let your work speak?

Experience project management that respects how you actually work. No workflows to learn, no habits to change—just clarity.

Try Peacae NowContact Us
How It Works | Peacae