Commandes

Utilisez cette page pour les commandes que les utilisateurs exécutent directement. Pour le premier setup, commencez par Installation.

Tâches courantes

• Premier setup: agent-note init
• Retirer Agent Note du dépôt: agent-note deinit
• Vérifier l’état: agent-note status
• Parcourir l’activité récente: agent-note log
• Afficher les données d’un commit: agent-note show
• Comprendre pourquoi une ligne a changé: agent-note why

Note

PR Report et Dashboard sont des fonctionnalités GitHub Actions. agent-note init crée normalement les fichiers de workflow; les rapports et le Dashboard sont produits ensuite par ces workflows.

agent-note init

Configure Agent Note dans le dépôt.

npx agent-note init --agent claude

Flag	Description
--agent <name...>	Choisir un ou plusieurs adaptateurs d’agent: claude, codex, cursor or gemini
--dashboard	Créer aussi le workflow du Dashboard partagé
--no-hooks	Ignorer la configuration des hooks de l’agent
--no-git-hooks	Ignorer l’installation des Git Hooks
--no-action	Ignorer la création des workflows
--no-notes	Ignorer la configuration de l’auto-fetch des notes
--hooks	Installer uniquement les hooks de l’agent
--action	Créer uniquement les workflows

agent-note deinit

Supprime les hooks et la configuration Agent Note pour un ou plusieurs agents.

npx agent-note deinit --agent claude

Flag	Description
--agent <name...>	claude, codex, cursor or gemini
--remove-workflow	Supprime aussi les workflows PR Report et Dashboard
--keep-notes	Conserve la configuration notes auto-fetch

agent-note status

Affiche l’état du suivi.

npx agent-note status

agent-note v1.x.x

agent:   active (cursor)
capture: cursor(prompt, response, edits, shell)
git:     active (prepare-commit-msg, post-commit, pre-push)
commit:  tracked via git hooks
session: a1b2c3d4…
agent:   cursor
linked:  3/20 recent commits

agent-note log

Liste les commits récents avec AI Ratio.

npx agent-note log
npx agent-note log 20

ce941f7 feat: add auth  [a1b2c3d4… | 🤖60% | 2p]
326a568 test: add tests [a1b2c3d4… | 🤖100% | 1p]
ba091be fix: update deps

agent-note show

Affiche la Session IA d’un commit.

npx agent-note show
npx agent-note show abc1234

commit:  ce941f7 feat: add JWT auth middleware
session: a1b2c3d4-5678-4abc-8def-111122223333

ai:      60% (45/75 lines) [█████░░░]
model:   claude-sonnet-4-20250514
agent:   claude
files:   3 changed, 2 by AI

  src/middleware/auth.ts  🤖
  src/types/token.ts  🤖
  CHANGELOG.md  👤

prompts: 2

  1. Implement JWT auth middleware with refresh token rotation
  2. Add tests for expired token and invalid signature

agent-note why

Affiche le contexte Agent Note derrière la ligne modifiée.

npx agent-note why src/middleware/auth.ts:42
npx agent-note why src/middleware/auth.ts:42-55
npx agent-note why src/middleware/auth.ts:42:7
npx agent-note why src/middleware/auth.ts#L42
npx agent-note why src/middleware/auth.ts#L42-L55
npx agent-note why src/middleware/auth.ts#L42C7
npx agent-note why @src/middleware/auth.ts#L42
npx agent-note why https://github.com/owner/repo/blob/main/src/middleware/auth.ts#L42
npx agent-note why file:///workspace/repo/src/middleware/auth.ts#L42
npx agent-note why vscode://file/workspace/repo/src/middleware/auth.ts:42:7

Note

why accepte les chemins path:line, path#Lline, les URLs GitHub, file://..., vscode://file... et les chemins préfixés par @ copiés depuis un AI Agent.

AI Agent Skill

Installez le skill Agent Note pour demander ces tâches en langage naturel.

gh skill install wasabeef/AgentNote agent-note --agent codex --scope user

Pour gh skill install, choisissez l’identifiant d’agent adapté: codex, claude-code, cursor or gemini-cli.