Griffe

Alpha. Lettre du matin pour un indépendant en SASU à l’IS : local-only, chiffré, sans serveur. Linux x86_64 pour l’instant.

Vitrine : https://dz9oo.github.io/griffe/. Captures : site/shots/.

Aujourd’hui

Trois pièces : Le jour, Les affaires, La société. Le courriel se lit dans la barre. Ce n’est pas une quatrième pièce.

Le jour dit quoi faire, et où en est l’argent. Les affaires tiennent les conversations, l’estimation (des lignes, pas un devis rédigé ici), les missions et les factures. La société tient la piste, le relevé que vous importez, ce que vous vous versez, les échéances et la clôture indicative.

Les lettres partent du compte réglé dans Le courrier. Les réponses de ce compte se lisent dans Courriel. Sans serveur, une relance peut encore ouvrir un brouillon .eml. La fenêtre n’écoute aucun port. Le coffre reste sur la machine.

Le mode d’emploi est dans l’application : le pied, Aide. Cette page dit ce qu’est le projet, comment l’installer, et comment y contribuer.

Ce que ça ne fait pas

Pas d’avis fiscal, pas de télétransmission, pas une plateforme agréée. Griffe calcule et rappelle ; tu déposes ailleurs.

Statut

Les tags v0.* sont de l’alpha. Aujourd’hui : 0.3.x, Linux x86_64, SASU à l’impôt sur les sociétés.

Vers une v1.0.0

Même périmètre (SASU à l’IS, Linux). Le produit quitte l’alpha :

• parcours Atelier (copy, densité du mois, seuil d’alarme de la piste) ;
• facture née dans Griffe (Factur-X) pour un dépôt humain sur une PA, si on n’émet plus ailleurs ;
• mises à jour guidées (lien Releases, signatures), sans socket au démarrage ;
• paquet AUR griffe-bin soumis ;
• notes de version et griffe --version alignés.

Ensuite

Même en v1.0.0 :

• Windows et macOS ;
• EURL comme régime distinct (gérant, TNS), micro-entreprise, impôt sur le revenu, multi-associés, stock, étranger ;
• EDI / télédéclaration, plateforme agréée, thème sombre, autre langue, coffre certifié NF Z42-013.

Installation

Linux (x86_64) : télécharger l’AppImage de la dernière version, chmod +x, puis l’installer dans ~/.local et le menu / Walker :

chmod +x ./Griffe_*.AppImage
scripts/install-griffe.sh ./Griffe_*.AppImage

Les Releases construites avec le secret GitHub MINISIGN_SECRET_KEY publient un .minisig à côté de l’AppImage. Le script le vérifie avant d’écrire, avec la clé embarquée : la même que packaging/minisign.pub et que minisign.pub. Il faut le paquet minisign (pacman -S minisign, apt install minisign). Les Releases déjà en ligne n’ont pas encore ce fichier. Le .sha256 reste un contrôle d’intégrité.

minisign -Vm ./Griffe_*.AppImage -p packaging/minisign.pub

Le script copie l’AppImage vers ~/.local/bin/griffe (un fichier, pas un lien), écrit l’icône et la fiche .desktop. Pas de sudo, pas de réseau. WebKit et Typst sont dans l’AppImage. Tes données restent dans ~/.local/share/griffe/ : rejouer le script ne touche pas au coffre. Un coffre déjà présent dans ~/.local/share/freeflow/ est déplacé vers griffe/ au premier lancement.

griffe est la ligne de commande. griffe desktop ouvre la fenêtre. griffe mcp parle à un agent. Le menu lance griffe desktop. Un double-clic sur Griffe_*.AppImage ouvre la fenêtre. Rejouer le script réécrit la fiche : une fiche ancienne, sans le mot desktop, ouvre l’aide au lieu de la fenêtre.

Mise à jour : télécharger le nouvel AppImage et rejouer le script (même chemin). Désinstall : rm des trois chemins, coffre intact.

rm ~/.local/bin/griffe \
  ~/.local/share/applications/io.github.dz9oo.griffe.desktop \
  ~/.local/share/icons/hicolor/256x256/apps/io.github.dz9oo.griffe.png

Sans le clone, copie scripts/install-griffe.sh depuis ce dépôt : le script vérifie la signature. Les trois commandes install / cat qui suivent copient le fichier, elles ne le vérifient pas.

chmod +x ./Griffe_*.AppImage
install -D ./Griffe_*.AppImage "$HOME/.local/bin/griffe"
chmod +x "$HOME/.local/bin/griffe"
tmp=$(mktemp -d)
(cd "$tmp" && "$HOME/.local/bin/griffe" --appimage-extract >/dev/null)
install -D "$tmp"/squashfs-root/usr/share/icons/hicolor/256x256/apps/*.png \
  "$HOME/.local/share/icons/hicolor/256x256/apps/io.github.dz9oo.griffe.png"
rm -rf "$tmp"
mkdir -p "$HOME/.local/share/applications"
cat >"$HOME/.local/share/applications/io.github.dz9oo.griffe.desktop" <<EOF
[Desktop Entry]
Type=Application
Name=Griffe
Exec="$HOME/.local/bin/griffe" desktop
Icon=io.github.dz9oo.griffe
StartupWMClass=Griffe-desktop
Terminal=false
Categories=Office;Finance;
EOF

Arch / Omarchy (paquet pacman)

Daily driver : le .pkg.tar.zst de la Release. Si une install XDG native (~/.local/lib/griffe/) existe, la retirer avant pacman -U (même id de fiche io.github.dz9oo.griffe.desktop) :

rm -f ~/.local/bin/griffe ~/.local/bin/griffe-desktop \
  ~/.local/lib/griffe/griffe-desktop ~/.local/lib/griffe/typst \
  ~/.local/share/applications/io.github.dz9oo.griffe.desktop
sudo pacman -U ./griffe-bin-*-x86_64.pkg.tar.zst

Le paquet pose un seul ELF. /usr/bin/griffe et /usr/bin/griffe-desktop sont deux liens vers ce fichier. griffe est la ligne de commande, griffe desktop ou le menu ouvrent la fenêtre, griffe mcp parle à un agent.

Pour une Release qui publie le .minisig, la vérification précède pacman -U :

minisign -Vm ./griffe-bin-<version>-1-x86_64.pkg.tar.zst -p packaging/minisign.pub

Désinstall : sudo pacman -Rns griffe-bin. Le coffre ~/.local/share/griffe/ ne bouge pas. Mise à jour : pacman -U le nouveau fichier.

Sans pacman, le tarball griffe-*-x86_64-linux.tar.xz et scripts/install-griffe-native.sh restent le geste ~/.local. Le script vérifie le .minisig du tarball de la même façon. Un répertoire déjà déballé sur la machine n’a pas cette signature. Il pose ~/.local/bin/griffe et ~/.local/bin/griffe-desktop vers le même ELF. Le menu lance griffe-desktop.

minisign -Vm ./griffe-<version>-x86_64-linux.tar.xz -p packaging/minisign.pub

L’AUR griffe-bin n’est pas soumis pour l’instant : le binaire pacman vit sur la GitHub Release, pas dans l’AUR.

Depuis les sources

nix develop
just check
cargo run -p griffe-desktop

Architecture

La fenêtre, la commande et l’agent ouvrent le même coffre et les mêmes gestes. Aucun port n’écoute. Le courriel sort vers le serveur écrit dans Le courrier, coffre ouvert, liaison chiffrée, et nulle part ailleurs.

Le détail, pour qui contribue : docs/architecture.md. Les invariants : AGENTS.md.

Licence

Le code est ouvert. Tu peux le lire, le modifier, t’en servir pour ta propre activité. Tu ne peux pas vendre Griffe, le proposer en service hébergé, ni le présenter comme un substitut, sans accord. Licence PolyForm Shield 1.0.0 (LICENSE, NOTICE).

« Griffe » désigne ce projet. Un fork se renomme.

Contribuer

CONTRIBUTING.md. Critère : just check.

Sécurité

SECURITY.md.

Contact

hello@nicolascollier.dev