/feedback

name: feedback
description: "Send feedback, ideas, or bug reports about Claudia. Opens a pre-filled GitHub Discussion with system context. Use when user says \"feedback\", \"suggestion\", \"report a bug\", \"feature request\", or \"I have an idea\"."
effort-level: low

Claudia Feedback

Help users share feedback, ideas, bug reports, or feature requests about Claudia. Opens a GitHub Discussion with auto-populated system info so the user just writes their message.

Trigger Phrases

• "feedback", "give feedback", "send feedback"
• "I have a suggestion", "feature request", "idea for Claudia"
• "report a bug", "something's broken", "I found a bug"
• "how do I report an issue"

Process

Step 1: Ask What's On Their Mind

Ask the user what kind of feedback they want to share. Keep it casual:

• "What's on your mind? Bug, idea, or just general feedback?"

If they've already described it, skip this step.

Step 2: Gather System Context

Collect system info silently (don't show raw data to user). Run these:

# Version
cat package.json 2>/dev/null | grep '"version"' | head -1

# OS and Node
echo "$(uname -s) $(uname -m), Node $(node -v 2>/dev/null)"

# Memory daemon health
~/.claudia/daemon/venv/bin/python3 -m claudia_memory --preflight 2>&1 | grep "Result:" || echo "Daemon: not checked"

# Memory count
sqlite3 ~/.claudia/memory/claudia.db "SELECT COUNT(*) FROM memories WHERE invalidated_at IS NULL;" 2>/dev/null || echo "0"

Step 3: Categorize

Map their feedback to a GitHub Discussions category:

| Feedback Type | Category | |--------------|----------| | Bug report | Ideas (no Bugs category by default) | | Feature request / idea | Ideas | | General feedback | General | | Question | Q&A |

Step 4: Build the Discussion URL

Construct a pre-filled GitHub Discussion URL. The URL format:

https://github.com/kbanc85/claudia/discussions/new?category={CATEGORY}&title={TITLE}&body={BODY}

The body should include: 1. The user's feedback (their words, not paraphrased) 2. A "System Info" section at the bottom with the collected context

**Body template:**

{user's feedback text}

---

**System Info** (auto-generated by Claudia)
- Version: {version}
- OS: {os}
- Node: {node_version}
- Memories: {count}
- Daemon: {healthy/not running}

URL-encode the title and body for the query string.

Step 5: Open in Browser

Use the Bash tool to open the URL:

# macOS
open "{url}"

# Linux
xdg-open "{url}" 2>/dev/null || echo "Open this URL: {url}"

# Windows
start "{url}"

Step 6: Confirm

Tell the user:

• "Opened a new discussion in your browser. Add any details and hit Submit."
• If the browser didn't open, show the URL directly so they can copy it.

Important

• **Never post feedback without the user's knowledge.** This opens a browser for them to review and submit.
• **Don't paraphrase their feedback.** Use their exact words in the body.
• **Keep system info minimal.** Version, OS, memory count. No sensitive data, no file paths, no personal info.
• **The user submits, not Claudia.** The browser opens a pre-filled form. The user reviews and clicks Submit.

GitHub Discussions URL

Repository: `kbanc85/claudia`

Direct link to create a discussion: `https://github.com/kbanc85/claudia/discussions/new`