gmgauthier/grokkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 10 Wiki Activity
6f6596c13f
grokkit/todo/queued/cnotes.md
Greg Gauthier 0cf0351826
All checks were successful
CI / Test (push) Successful in 33s
Details
CI / Lint (push) Successful in 26s
Details
CI / Build (push) Successful in 21s
Details
chore(todo): remove priorities from queued items and add admin tool 
- Removed priority lines from various TODO markdown files
- Added new admin.md for grokkit admin tool
- Updated README.md with new entry
2026-03-04 19:23:03 +00:00

2.4 KiB
Raw Blame History

grokkit agent cnotes integration

Description: Wrappers for your cnotes CLI logging suite. Allows Grok to automatically log coding sessions, notes, progress during agent workflows (e.g., "start work on feature", "log bug found").

Problem It Solves

Developers track time/effort manually. Integrate cnotes (cnadd/cndump/etc.) for AI-assisted logging: timestamps, descriptions, stats—seamless with code edits.

Benefits

  • Automated logging: Grok logs at key points (start/edit/commit).
  • Queryable: Search/dump stats via AI ("Show time on agent tasks today").
  • Safe: Append-only (cnadd), read-only queries (cnfind/cncount); no deletes.
  • Terminal-native: Fast C impl, no deps.
  • Workflow boost: "Refactor → log changes → stats".

Agent Tool Examples

grokkit agent "Start logging session, fix main.go, log completion"
# Grok: cnadd "start: agent refactor main.go" → edits → cnadd "done: fixed errors"

grokkit agent "Log today's coding stats before planning"
# Grok: cncount → cnfind "today" → "2h on edits, 3 sessions"

High-Level Implementation

  1. Detect cnotes: Run cnhelp or which cnotes.
  2. Tool schemas:
    • log_note(message: string) → ok
    • list_notes(filter?: string) → string
    • session_stats() → string
  3. Wrappers in internal/tools/cnotes.go: 
    func LogNote(ctx context.Context, args map[string]any) (string, error)
  4. Agent integration: Auto-log on milestones; user-prompted.
  5. Safety:
    • Only cnadd/cndump/cnfind/cncount.
    • Preview log message.
    • Config: [tools.cnotes.enabled].
  6. Parsing: Stdout JSON? Or simple text.

Flags / Config

Key Description
tools.cnotes.enabled Enable cnotes tools
--auto-log Log start/end automatically

Implementation Notes

  • Commands: cnadd (log), cndump (all), cnfind (search), cncount (stats), cndel (archive—whitelist carefully).
  • Extend agent: Tool calls in loop.
  • Errors: Custom CnotesError.
  • Tests: Mock exec.Command, table-driven.
  • Effort: Low (~150 LOC). Simple exec wrappers.
  • Prereq: cnotes in PATH (cnhelp verifies).

ROI

High. Personal logging elevates from code tool to dev productivity hub:

Stage Covered
Logging cnotes ← new
Code agent ✓
Repo tea (sibling)

Quantifiable: Track hours/features automatically.