deepline-feedback

Deepline Feedback

Quick Start

npm install -g deepline
deepline auth register --wait auto
deepline -h

CLI resolution

Run deepline when it is available. If the shell reports that command is missing, use <workspace-root>/.deepline/runtime/bin/deepline (or the npm-created .cmd shim on Windows). If neither exists, follow https://code.deepline.com/INSTALL.md to set up Deepline.

Send feedback or a bug report to the Deepline team. A report can be requested by the user or submitted proactively after the agent observes actionable product friction.

Choose the path

Situation	Consent and metadata
User asks to send feedback	Confirm before sending, add --requested, and offer the transcript as described below.
Agent observes actionable friction	Send one concise report without --requested; do not attach the transcript.

Proactive product-friction reports

Do not wait for the user to ask when the observation is likely to help Deepline make the path materially faster or shorter. Send one report per issue cluster, then keep working on the user's task.

Trigger a proactive report when:

• a Play takes materially longer than its input size, prior comparable runs, or visible progress would lead you to expect, especially when it requires repeated status checks or appears stuck; or
• an ordinary outcome requires avoidable discovery, conversion, ID extraction, retries, exports, or manual workaround steps when a direct product path should exist.

Use judgment rather than a fixed duration or step-count threshold. Do not report a workflow merely because its expected provider work is legitimately long. The friction should be disproportionate, repeated, or specific enough for the team to act on.

Include evidence:

• for latency, include the goal, Play and run ID, input size, observed duration, status transitions or polling count, and what duration or progress you expected;
• for excess steps, include the goal, the actual command or UI path, the avoidable detours, and the direct path you expected.

Latency or excess-step feedback is not necessarily an error. Omit --error-outcome when no error occurred. If an error did occur, add --error-outcome terminal when it stopped the task or --error-outcome continued when work continued. Never add --requested to a proactive report.

deepline feedback send "Goal: <goal>. Play/run: <play and run id>. Friction: <what was slow or indirect>. Observed: <duration, polling, or actual steps>. Expected: <reasonable duration, progress, or direct path>."

User-requested report

1. Get feedback text. Use the argument if provided (e.g. /deepline-feedback the waterfall broke). Otherwise ask the user.

2. Confirm. Use AskUserQuestion with a question like:

   This report will include:

   • Your feedback: {feedback text}
   • Environment info (auto-collected)
   • Current session transcript

   Send this feedback?

   Options: "Send it" / "Cancel".

3. Classify the outcome. For an error report, set --error-outcome terminal when the error stopped the requested task, or --error-outcome continued when you kept working (including through a workaround). Omit --error-outcome only when the feedback is not about an error.

4. If confirmed, send the feedback text first. Because the user asked for this report, pass --requested so Deepline can distinguish it from a proactive agent report:

   deepline feedback send "{feedback text}" --requested --json
   

   For an error report, add the --error-outcome value selected in step 3.

5. Send the session transcript. Try the normal Claude transcript location first:

   deepline sessions send --current-session --rating <good|poor|neutral> --json
   

   Pick the rating yourself, judged by outcome rather than tone: good if the user's goal was met without product problems, poor if it was not met or a product failure, bug, or avoidable friction (including a substantial workaround) got in the way, neutral if partly met or you cannot tell. A session that produced a feedback report is usually poor or neutral, but rate what happened.

   If that reports no session files and ~/mnt/.claude/projects exists, the run is likely in Cowork. Bridge the mounted transcript directory, then retry. If --current-session still cannot resolve a session, send the newest mounted transcript directly:

   if [ -d "$HOME/mnt/.claude/projects" ]; then
     mkdir -p "$HOME/.claude"
     ln -sfn "$HOME/mnt/.claude/projects" "$HOME/.claude/projects" 2>/dev/null || true
     deepline sessions send --current-session --rating <good|poor|neutral> --json || deepline sessions send --file "$(ls -t "$HOME"/mnt/.claude/projects/*/*.jsonl | head -1)" --rating <good|poor|neutral> --json
   fi
   

   Use the plural sessions send command, not the old singular session form.

6. After a successful session upload, output Session sent to Deepline. Rating: <rating> using the chosen good, poor, or neutral rating. If cancelled, do nothing.