ulk

AI Development Toolkit pour Claude Code.

Pourquoi "ulk" ?

Bruce, de son vrai nom Ulk, est un Vallhund suédois — une race de chien viking millénaire, trapue et intrépide, surnommée "le chien des Vikings".

Comme son ancêtre qui accompagnait les drakkars à travers les mers nordiques, Ulk accompagne les développeurs à travers les océans de code. Petit mais costaud, il ne recule devant aucun défi.

Le nom "ulk" signifie "loup" en vieux norrois.

Installation

curl -fsSL https://raw.githubusercontent.com/izo/ulk/main/install-remote.sh | bash

Ou depuis le dépôt cloné :

./install.sh                          # Installation de base (inclut Figma + Swift + Flutter skills)
./install.sh --with-figma-mcp         # + configurer le serveur MCP Figma
./install.sh --with-vps               # + agents VPS
./install.sh --with-teams             # + Agent Teams
./install.sh --with-addy-skills       # + skills addyosmani
./install.sh --with-a11y-skills       # + skills accessibilité (RAWeb/RAAM)
./install.sh --with-obsidian-skills   # + skills Obsidian (kepano)
./install.sh --with-nothing-design    # + skill Nothing design system (dominikmartn)
./install.sh --with-memory-loop       # + hooks memory loop
./install.sh --with-cli-telemetry     # + suivi usage CLI → ./tools/cli-report.sh
./install.sh --with-caveman-skill     # + /caveman-compress — compression CLAUDE.md (-46% tokens)
./install.sh --install-deps           # Installer les CLIs manquants (sélecteur interactif)
./install.sh --check                  # Diagnostic CLI + Skills
./install.sh --verify                 # Vérifier l'installation

# Optionnel (macOS 26+ Apple Silicon)
brew install Arthur-Ficial/tap/apfel  # LLM local Apple Intelligence

Mise à jour : git pull && ./install.sh — Désinstallation : ./install.sh --uninstall

CLI Go (v5+)

À partir de v5, ulk est distribué comme un binaire Go unique (ulk) qui remplace progressivement install.sh. Le bash reste en wrapper de compatibilité.

ulk install [--with-*]    # installation avec TUI wizard au premier run
ulk update [--check]      # diff checksums + rollback auto sur erreur
ulk uninstall [--module]  # désinstalle un module ou tout (--all)
ulk status                # modules ✓/○ + version
ulk verify                # chemins + prérequis + LLM locaux
ulk check                 # CLIs + skills installés

État persistant dans ~/.ulk/state.json (écriture atomique). Backup/rollback automatique. 14 modules opt-in (Figma, Swift, Flutter, VPS, Agent Teams…).

Architecture, flux et build local : docs/guides/cli-go.md

Par où commencer

Commande	Ce que ça fait
/ulk:bruce	Point d'entrée principal — détecte l'état du projet et orchestre tout
/ulk:godspeed	Diagnostic rapide : stack, état, prochaine action suggérée
/ulk:shuri	Pipeline doc : spec → todo Kanban → sync
/ulk:sargeras	Audit omniscient 10 axes avec score et verdict
/ulk:2b3	Checkpoint fin de session : lint → docs → commit
/ulk:strange	Reverse doc (code → docs) · mode=prompt : reverse-engineering de prompt (output IA → prompt probable)

Mobile Natif

Pipeline complet web-vers-mobile en 3 agents :

happy (49)  →  docs/api/  →  steve (27) + fluke (48)
   API architect      OpenAPI 3.1      iOS/macOS    Android/Flutter

• Happy audite le projet web, conçoit l'API REST/GraphQL complète (auth, push, offline sync)
• Steve lit docs/api/ et génère un starter kit SwiftUI compilable (+ 7 Swift skills bundlés)
• Fluke lit docs/api/ et génère un starter kit Kotlin/Compose ou Flutter (+ 2 Flutter skills bundlés)

Apple Intelligence (optionnel)

Sur macOS 26+, ulk delegue les micro-taches (extraction, classification, resume) a Apfel — Apple Intelligence en local, gratuit, 0 tokens Claude.

brew install Arthur-Ficial/tap/apfel   # installer
./install.sh --check                   # verifier la detection

10 agents l'utilisent automatiquement si present : godspeed, 2b3, vision, robocop, shuri, friday, strange, lovecraft, sargeras, ed209. Chaque invocation est tracee dans docs/apfel-report.md (stats cumulatives). Sans apfel, tout fonctionne normalement (fallback Claude).

Community Skills (bundlés)

Collection	Skills	Source
Figma (7)	figma-use, figma-implement-design, figma-code-connect, figma-generate-library, figma-generate-design, figma-create-design-system-rules, figma-create-new-file	Figma Inc.
Swift (7)	SwiftUI Pro, SwiftData Pro, Concurrency, Testing, A11y, Architecture, Security	twostraws + communauté
Flutter (2)	Flutter Tester, OWASP Mobile Security	Harishwarrior
Nothing design (1)	nothing-design — design system minimaliste (Swiss typography, Braun/Teenage Engineering)	dominikmartn
context-audit (1)	/context-audit — health score 0-100 : MCP servers, CLAUDE.md bloat, skills, settings	Vesely/skills

Installés automatiquement par ./install.sh : Figma, Swift, Flutter, context-audit.
Config MCP Figma : ./install.sh --with-figma-mcp
Optionnels : --with-nothing-design (dominikmartn) · --with-a11y-skills (RAWeb/RAAM) · --with-obsidian-skills (kepano).

Prérequis

• Claude Code — claude.ai/code (Desktop, Web, ou CLI)
• git — cloner et mettre à jour ulk
• Node.js 18+ — pour les générateurs (cheatheet/)
• macOS ou Linux — install.sh est un script bash
• curl — pour l'installation distante (déjà présent sur macOS/Linux)

Agents (78)

Liste complète par catégorie : agents/registry.md

Catégories : orchestrators/ · docs/ · audit/ · session/ · mobile/ · sync/ · routines/ · frontend/ · analyze/ · deploy/ · test/ · vps/

Documentation

• Guide — Démarrage, workflows, FAQ
• ADR — Décisions d'architecture et leurs raisons
• Glossaire — Terminologie ulk
• Spec projet — État et roadmap du projet