Pierre Martin pierre

Joined on 2020-11-08

piaire (2.0.0)

Published 2026-03-31 20:53:39 +00:00 by pierre

Set up this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install piaire@2.0.0

or add it to the package.json file:

"piaire": "2.0.0"

For more information on the npm registry, see the documentation.

piaire

Dashboard de gestion de tâches personnel, connecté à Tuleap et GitLab, avec orchestration d'agents Claude.

Vision

Un espace de travail unifié pour Pierre :

Dashboard web : matrice Eisenhower, triage, archivage automatique, liens Tuleap/GitLab
Agents Claude : lancer un agent IA sur une tâche directement depuis le dashboard (streaming SSE)
/piaire dans Claude Code : orchestrateur en langage naturel pour interagir avec le dashboard

Quick start

# Prérequis : NixOS avec direnv
cd piaire/
direnv allow

# Dashboard web (watch mode)
make serve    # → http://localhost:3117

Publication (mainteneur)

Le package est publié sur le registry npm de git.sans.pub.

1. Configurer le token Gitea

Dans Gitea : Paramètres → Applications → Générer un token Scopes requis : package:read, package:write

cp .npmrc.example .npmrc
# Renseigner <TOKEN> dans .npmrc

2. Publier une version

Mettre à jour version dans package.json, puis :

make release

Cela publie le package sur le registry et crée le tag git v<version>.

3. Distribuer le skill d'installation

Les utilisateurs récupèrent le skill en une commande :

mkdir -p ~/.claude/skills/install-piaire
curl -o ~/.claude/skills/install-piaire/SKILL.md \
  https://git.sans.pub/pierre/piaire/raw/branch/main/claude/skills/install-piaire/SKILL.md

Puis dans Claude Code : /install-piaire

Architecture des données

~/.piaire/
  settings.json            # Config (refresh interval, startup sync)
  sync-state.json          # Dernier sync Tuleap/GitLab
  projects/
    <slug>/
      project.yaml         # Config projet (trackers Tuleap, repos GitLab)
      CLAUDE.md            # Contexte projet injecté dans les agents
      tasks/
        <id>/
          task.md          # Tâche (YAML frontmatter + corps Markdown)
          notes.json       # Notes manuelles
          mr-<iid>.md      # MRs GitLab liées

Utilisation Claude Code

/piaire                     → ouvre le dashboard dans le navigateur
/piaire refresh             → synchronise Tuleap + GitLab
/piaire démarre             → lance piaire serve si pas actif

Le hook PostToolUse se déclenche automatiquement après certaines actions Git.

Roadmap

Phase 1 : modèles de données, FilesystemStore, dashboard HTMX
Phase 2 : intégration Tuleap + GitLab, sync automatique
Phase 3 : agents Claude (bridge Agent SDK, streaming SSE)
Phase 4 : sessions, notes, gestion avancée des tâches
Phase 5 : polish — cache mémoire, gestion d'erreurs, documentation

Dependencies

ID	Version
@anthropic-ai/claude-agent-sdk	^0.2.84
@anthropic-ai/sdk	^0.80.0
eta	^3.5.0
express	^5.1.0
marked	^17.0.5
marked-emoji	^2.0.2
node-emoji	^2.2.0
pino	^10.3.1
pino-pretty	^13.1.3
smol-toml	^1.6.1
yaml	^2.7.1
zod	^4.3.6

Development Dependencies

ID	Version
@biomejs/biome	^1.9.0
@types/express	^5.0.0
@types/node	^24.0.0
typescript	^5.8.0
vitest	^3.2.0

Details

npm

2026-03-31 20:53:39 +00:00

latest

423 KiB

Assets (1)

piaire-2.0.0.tgz 423 KiB

Versions (1) View all

2.0.0

2026-03-31