gmgauthier/grokkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 10 Wiki Activity
3ea26c403a
grokkit/todo/queued/tea.md
Greg Gauthier b884f32758
All checks were successful
CI / Test (push) Successful in 33s
Details
CI / Lint (push) Successful in 25s
Details
CI / Build (push) Successful in 19s
Details
chore(todo): add priorities to queued items and new tool integration plans 
- Added priority markers (e.g., "Priority: X of 12") to existing queued TODOs like audit, changelog, profile, scaffold.
- Introduced new detailed TODO markdowns for agent integrations: cnotes, git-chglog, gotools, make, pprof, rg, tea.
- Enhances planning for grokkit agent tooling ecosystem.
2026-03-02 23:42:06 +00:00

2.7 KiB
Raw Blame History

grokkit agent tea integration

Priority: 5 of 12

Description: Safe, AI-orchestrated wrappers for Gitea tea CLI commands. Enables Grok to manage repos (list/create PRs/issues, comments) as part of agent workflows, with previews and confirmations.

Problem It Solves

Grokkit's agent excels at code edits but lacks repo mgmt. Developers context-switch to browser/CLI for Gitea actions. Integrate tea for seamless: "Review PRs, create issue for bugs, log progress".

Benefits

  • Safe execution: Whitelisted commands/args, dry-run previews, confirm destructive ops (merge/push).
  • AI reasoning: Grok decides when to call tea (e.g., "After edits, create PR").
  • Logging: All calls logged to ~/.config/grokkit/tools.log.
  • Repo-aware: Combines with git (internal/git), code edits.
  • No new deps: Uses os/exec for tea (assume installed).

Agent Tool Examples

grokkit agent "List open PRs, pick one to work on, create branch"
# Grok: tea pr ls → Analyzes → tea branch create fix-123 → edits files

grokkit agent "Fix lint, create issue if high-risk changes"
# Grok: Runs lint → tea issue create "High-risk refactor"

High-Level Implementation

  1. Detect tea: Check exec.Command("tea", "version").
  2. Tool schemas (Grok tool-calling JSON):
    • list_prs(state: "open") → string
    • create_pr(title, body, base) → pr_url
    • comment_pr(pr_id, body)
    • merge_pr(pr_id)
  3. Wrapper funcs in internal/tools/tea.go: 
    func ListPRs(ctx context.Context, args map[string]any) (string, error)
  4. Agent loop (cmd/agent.go): Parse tool calls → Execute → Feed output back.
  5. Safety:
    • Whitelist: pr ls/create/comment/merge, issue create/comment.
    • Preview: Print tea ... + expected output.
    • Confirm: User y/n for each.
  6. Config: [tools.tea.enabled], [tools.tea.gitea_url].

Flags / Config

Key Description
tools.tea.enabled Enable tea tools
tools.tea.gitea_url Override repo URL
--dry-run Simulate tool calls

Implementation Notes

  • Extend agent: Modify plan phase to include tool suggestions.
  • Error handling: internal/errors + GitError-like TeaError.
  • Tests: Table-driven TestTeaTools with mocks (exec.Command patching).
  • Effort: Medium (~200 LOC). Reuse grok client, agent UX.
  • Prereq: User installs tea (go install github.com/go-tea/tea/cmd/tea@latest).

ROI

High. Closes workflow gap:

Stage Covered
Code edit agent ✓
Repo mgmt tea tools ← new
Logging cnotes (next)

Force-multiplies daily PR/issue workflows.