Skip to content

Use prompt suggestions

Nerve shows reusable prompt chips above the composer. Manage them in Settings → Suggestions → Prompt suggestions.

Three contextual Git suggestions are included:

  • Commit changes when a repository has uncommitted changes.
  • Commit on a feature branch when changes are on a base branch.
  • Create a PR when a relevant GitHub repository is ready and GitHub CLI is authenticated.

Settings lists built-ins even when their runtime condition is false. Each can be disabled independently.

Create suggestions in Settings or edit Markdown files:

  • User: ~/.nerve/suggestions/*.md or $NERVE_HOME/suggestions/*.md
  • Project: <project>/.nerve/suggestions/*.md

Project definitions override user definitions with the same name; user definitions override built-ins. A disabled higher-precedence definition remains authoritative instead of revealing the lower one. Settings identifies shadowed definitions.

A definition can set label, description, order, default enabled state, prompt body, and declarative conditions for Git state, mode, and permission. See the format reference.

An enable-js/enable.js predicate can synchronously inspect JSON-safe project, Git, conversation, and agent context. Nerve does not run it until you approve the warning. Trust is tied to a hash of the predicate; editing code requires approval again.