@ignitionai/cogitator 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -21
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,18 +1,20 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
<img src="https://raw.githubusercontent.com/IgnitionAI/cogitator/dev/web/public/icon.png" width="120" alt="Cogitator —
|
|
3
|
+
<img src="https://raw.githubusercontent.com/IgnitionAI/cogitator/dev/web/public/icon.png" width="120" alt="Cogitator — nebula gear logo" />
|
|
4
4
|
|
|
5
5
|
# Cogitator
|
|
6
6
|
|
|
7
|
-
**
|
|
7
|
+
**A web control panel for [pi](https://pi.dev)** — composable agents, workspaces, GitHub-native kanban, and scheduled tasks.
|
|
8
8
|
|
|
9
9
|
[](https://www.npmjs.com/package/@ignitionai/cogitator)
|
|
10
10
|
[](https://pi.dev/packages)
|
|
11
|
-
[](
|
|
11
|
+
[](#license)
|
|
12
12
|
|
|
13
13
|
</div>
|
|
14
14
|
|
|
15
|
-
Cogitator
|
|
15
|
+
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.
|
|
16
|
+
|
|
17
|
+
The application currently has a French-language interface. The documentation is in English.
|
|
16
18
|
|
|
17
19
|
## Installation
|
|
18
20
|
|
|
@@ -20,35 +22,35 @@ Cogitator orchestre tes processus pi depuis un navigateur : tu composes des agen
|
|
|
20
22
|
pi install npm:@ignitionai/cogitator
|
|
21
23
|
```
|
|
22
24
|
|
|
23
|
-
|
|
25
|
+
Then, in pi:
|
|
24
26
|
|
|
25
27
|
```text
|
|
26
|
-
/cogitator #
|
|
28
|
+
/cogitator # starts the detached server and opens http://127.0.0.1:5320
|
|
27
29
|
```
|
|
28
30
|
|
|
29
|
-
|
|
31
|
+
Or run it standalone: `npx @ignitionai/cogitator` (Node.js ≥ 22.19.0).
|
|
30
32
|
|
|
31
|
-
##
|
|
33
|
+
## Features
|
|
32
34
|
|
|
33
|
-
- **
|
|
34
|
-
- **
|
|
35
|
-
- **
|
|
36
|
-
- **
|
|
37
|
-
- **
|
|
38
|
-
- **Conversations** —
|
|
39
|
-
- **
|
|
40
|
-
- **
|
|
41
|
-
- **Providers
|
|
35
|
+
- **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`).
|
|
36
|
+
- **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.
|
|
37
|
+
- **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.
|
|
38
|
+
- **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.
|
|
39
|
+
- **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.
|
|
40
|
+
- **Conversations** — SSE streaming with reconnection recovery, copyable code, structured tool output and diffs, pasted images, history, and skills invoked with `/skill:name`.
|
|
41
|
+
- **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](https://github.com/IgnitionAI/cogitator/blob/dev/docs/chat-generative-ui.md).
|
|
42
|
+
- **Scheduled tasks** — cron scheduling with concurrent-run protection, catch-up behavior, run history, and notifications.
|
|
43
|
+
- **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.
|
|
42
44
|
|
|
43
45
|
## Architecture
|
|
44
46
|
|
|
45
|
-
|
|
47
|
+
Specifications live in [`docs/`](https://github.com/IgnitionAI/cogitator/tree/dev/docs): [domain model](https://github.com/IgnitionAI/cogitator/blob/dev/docs/architecture/domain-model.md), [blueprint](https://github.com/IgnitionAI/cogitator/blob/dev/docs/architecture/blueprint.md), [API contract](https://github.com/IgnitionAI/cogitator/blob/dev/docs/architecture/api-contract.md), and [architecture decisions](https://github.com/IgnitionAI/cogitator/tree/dev/docs/context/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 92 tests.
|
|
46
48
|
|
|
47
49
|
```text
|
|
48
|
-
Browser (React) → REST + SSE →
|
|
49
|
-
|
|
50
|
+
Browser (React) → REST + SSE → Node server → pool of `pi --mode rpc` processes
|
|
51
|
+
↕ SQLite in ~/.cogitator + native pi files
|
|
50
52
|
```
|
|
51
53
|
|
|
52
|
-
##
|
|
54
|
+
## License
|
|
53
55
|
|
|
54
56
|
MIT — © IgnitionAI
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ignitionai/cogitator",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "A web control panel for pi: composable agents, workspaces, interactive conversations, and scheduled tasks. A pi package.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"pi-package",
|