feat: add brev feedback command (#324)

* feat: add brev feedback command for user feedback via PostHog

Add a new `brev feedback` command that lets users send feedback, bug
reports, and feature requests directly from the CLI. Feedback is sent
as a `brev-cli-feedback` event to PostHog.

Also update the agent skill SKILL.md to instruct AI agents to
proactively send feedback when they encounter issues.

* fix: use format string in Vprintf call

* fix: use logged-in user ID for feedback events when available

* fix: warn users not to include secrets in feedback

* fix: remove secrets warning from long description, keep in prompt only

* fix: move secrets warning to skill only

Author: theFong

.agents/skills/brev-cli/SKILL.md

@@ -247,6 +247,22 @@ brev invite
 - Confirm instance name before deletion
 - Check `brev ls` before assuming instance exists
 
+## Feedback
+
+If you get stuck, encounter bugs, can't achieve what you're trying to do, or have ideas for improvements, send feedback to the Brev team:
+
+```bash
+brev feedback "description of issue or suggestion"
+```
+
+**IMPORTANT: Never include secrets, passwords, API keys, or sensitive information in feedback.**
+
+Do this proactively when:
+- A brev command fails unexpectedly or returns confusing errors
+- You can't figure out how to accomplish a task with the available commands
+- You notice missing features or rough edges
+- A workflow feels harder than it should be
+
 ## Troubleshooting
 
 **"Instance not found":**

pkg/analytics/posthog.go

@@ -279,6 +279,32 @@ func captureEvent(userID string, cmd *cobra.Command, args []string, succeeded bo
 	})
 }
 
+// CaptureFeedback sends a brev-cli-feedback event to PostHog.
+// This is sent regardless of analytics opt-in since the user explicitly chose to send feedback.
+func CaptureFeedback(userID, message string) {
+	if userID == "" {
+		userID = GetOrCreateAnalyticsID()
+	}
+	if userID == "" {
+		return
+	}
+
+	c, err := getClient()
+	if err != nil {
+		return
+	}
+
+	_ = c.Enqueue(posthog.Capture{
+		DistinctId: userID,
+		Event:      "brev-cli-feedback",
+		Properties: posthog.NewProperties().
+			Set("message", message).
+			Set("os", runtime.GOOS).
+			Set("arch", runtime.GOARCH).
+			Set("cli_version", version.Version),
+	})
+}
+
 // Close flushes any pending events and closes the PostHog client.
 func Close() {
 	if client != nil {

pkg/cmd/cmd.go

@@ -17,6 +17,7 @@ import (
 	"github.com/brevdev/brev-cli/pkg/cmd/enablessh"
 	"github.com/brevdev/brev-cli/pkg/cmd/envvars"
 	"github.com/brevdev/brev-cli/pkg/cmd/exec"
+	"github.com/brevdev/brev-cli/pkg/cmd/feedback"
 	"github.com/brevdev/brev-cli/pkg/cmd/fu"
 	"github.com/brevdev/brev-cli/pkg/cmd/gpucreate"
 	"github.com/brevdev/brev-cli/pkg/cmd/gpusearch"
@@ -358,6 +359,7 @@ func createCmdTree(cmd *cobra.Command, t *terminal.Terminal, loginCmdStore *stor
 	cmd.AddCommand(recreate.NewCmdRecreate(t, loginCmdStore))
 	cmd.AddCommand(writeconnectionevent.NewCmdwriteConnectionEvent(t, loginCmdStore))
 	cmd.AddCommand(updatemodel.NewCmdupdatemodel(t, loginCmdStore))
+	cmd.AddCommand(feedback.NewCmdFeedback(t, noLoginCmdStore))
 }
 
 func hasWorkspaceCommands(cmd *cobra.Command) bool {

pkg/cmd/feedback/feedback.go

@@ -0,0 +1,52 @@
+package feedback
+
+import (
+	"strings"
+
+	"github.com/brevdev/brev-cli/pkg/analytics"
+	"github.com/brevdev/brev-cli/pkg/entity"
+	"github.com/brevdev/brev-cli/pkg/terminal"
+	"github.com/spf13/cobra"
+)
+
+type FeedbackStore interface {
+	GetCurrentUser() (*entity.User, error)
+}
+
+func NewCmdFeedback(t *terminal.Terminal, store FeedbackStore) *cobra.Command {
+	var message string
+
+	cmd := &cobra.Command{
+		Annotations:           map[string]string{"configuration": ""},
+		Use:                   "feedback [message]",
+		DisableFlagsInUseLine: true,
+		Short:                 "Send feedback to the Brev team",
+		Long:                  "Send feedback, bug reports, or feature requests to the Brev team.",
+		Example:               "brev feedback \"I love this tool!\"\nbrev feedback",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			if message == "" && len(args) > 0 {
+				message = strings.Join(args, " ")
+			}
+			if message == "" {
+				message = terminal.PromptGetInput(terminal.PromptContent{
+					Label:    "What feedback do you have for us?",
+					ErrorMsg: "Please enter some feedback",
+				})
+			}
+
+			userID := analytics.GetOrCreateAnalyticsID()
+			if user, err := store.GetCurrentUser(); err == nil && user != nil {
+				userID = user.ID
+			}
+
+			analytics.CaptureFeedback(userID, message)
+
+			t.Vprintf("%s", t.Green("Thanks for your feedback! We really appreciate it.\n"))
+			return nil
+		},
+	}
+
+	cmd.Flags().StringVarP(&message, "message", "m", "", "Feedback message (skips interactive prompt)")
+
+	return cmd
+}