Cogitator

A web control panel for pi — composable agents, workspaces, GitHub-native kanban, and scheduled tasks.

Cogitator lets you orchestrate pi processes from your browser: compose agents from a provider, model, thinking level, skills, MCP servers, and subagents; manage project workspaces; and dispatch work through a kanban board backed by GitHub Issues. Track the work through modified files, diffs, and a chronological activity feed.

The entire application interface is available in English and French. Use the Language / Langue selector in the sidebar (inside the menu on mobile). The first visit follows the browser’s supported language preference, falling back to English; your choice is remembered locally and updates open screens without losing drafts. Dates and numbers follow the selected language, without changing the scheduling timezone.

User content, agent responses, editable agent presets, code, files, and technical identifiers are preserved as authored. Cogitator’s controls and diagnostic explanations are translated; external diagnostic details remain available in their original form. The documentation is in English.

Installation

pi install npm:@ignitionai/cogitator

Then, in pi:

/cogitator          # starts the detached server and opens http://127.0.0.1:5320

Or run it standalone: npx @ignitionai/cogitator (Node.js ≥ 22.19.0).

VPS access preparation (experimental)

The default application remains a trusted, loopback-only local service, not a secured remote deployment. Do not expose it through a public proxy.

The local native single-owner login and MFA implementation has passed independent code re-reviews and bounded local verification, including Node 22/26 and real local HTTPS/browser journeys. It is independent of a particular VPS or identity provider, but authentication is not agent execution isolation. See the evidence and remaining gates. This working-tree increment is not a new published release. Public remote operation, autonomous recovery and the remaining Durable work are not approved by it.

The earlier identity-service inventory is historical, suspended repository tooling; its administrator handoff is no longer requested. No remote deployment or recovery gate is certified by these documents.

Features

• Composable agents — each preset combines a provider, model, thinking level, explicit skill set, MCP servers, scope prompt, and subagents. These become native pi flags when the process starts (--model id:thinking, --no-skills --skill …, --append-system-prompt).
• Three built-in agents — Majordome (the default operator), Chef de Projet (project management, board dispatch, and the to-tickets/use-delegate methods), and Architecte de Skills (SKILL.md authoring). Includes their skills and the Cogitator MCP server with 28 tools.
• Project workspaces — a dedicated page for each directory, with a board, file activity (+/−), chronological feed, read-only file tree, team overview, project manager chat, and one-click project setup.
• GitHub-native kanban — each card is a GitHub issue, with status:/priority: labels, native blocking relationships, and writes through gh. No synchronization layer: GitHub remains the single source of truth.
• Agent dispatch — use “Lancer l’agent” (launch agent) on a ticket to start a conversation in its workspace, link the card to its activity, and move it to in progress.
• Conversations — SSE streaming with reconnection recovery, copyable code, structured tool output and diffs, pasted images, history, and skills invoked with /skill:name.
• Automatic interactive UI — agents choose between text, forms, choices, checklists, and tables as needed, in both standalone and workspace conversations. Responses are submitted explicitly and saved in pi JSONL transcripts. Generated HTML and JavaScript are never executed. See the contract and limitations.
• Scheduled tasks — cron scheduling with concurrent-run protection, catch-up behavior, run history, and notifications.
• Providers and skills — inspect pi configuration, check authentication with pi auth check, use atomic writes with backups, and import skills from GitHub, local directories, or npm commands.

Architecture

Specifications live in docs/: domain model, blueprint, API contract, and architecture decisions. They cover apply-on-spawn configuration, MCP registration through registerMcpServer, and the GitHub-backed board's single-writer model. The project uses strict TypeScript, Zod validation at boundaries, and a regression test suite.

Browser (React) → REST + SSE → Node server → pool of `pi --mode rpc` processes
                                  ↕ SQLite in ~/.cogitator + native pi files

License

MIT — © IgnitionAI