← All docs

DOCS

  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
DOCS
  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
ON THIS PAGE
  1. Locations
  2. Format
  3. Argument Hints
  4. Usage
  5. Arguments
  6. Loading Rules

Prompt Templates

Prompt templates are Markdown snippets that expand into full prompts. Type /name in the editor to invoke a template, where name is the filename without .md.

#Locations

Neo Code loads prompt templates from:

  • Global: ~/.neo-code/agent/prompts/*.md
  • Project: .neo-code/prompts/*.md
  • Packages: prompts/ directories or neosantara.prompts entries in package.json
  • Settings: prompts array with files or directories
  • CLI: --prompt-template <path> (repeatable)

Disable discovery with --no-prompt-templates.

#Format

---
description: Review staged git changes
---
Review the staged changes (`git diff --cached`). Focus on:
- Bugs and logic errors
- Security issues
- Error handling gaps
  • The filename becomes the command name. review.md → /review.
  • description is optional. If missing, the first non-empty line is used.
  • argument-hint is optional. Displayed before description in autocomplete.

#Argument Hints

Use argument-hint in frontmatter to show expected arguments:

---
description: Review PRs from URLs with structured analysis
argument-hint: "<PR-URL>"
---

Renders in autocomplete as:

→ pr   <PR-URL>       — Review PRs from URLs with structured analysis
  wr   [instructions] — Finish the current task end-to-end

Use <angle brackets> for required, [square brackets] for optional.

#Usage

Type / followed by the template name. Autocomplete shows available templates.

/review                           # Expands review.md
/component Button                 # Expands with argument
/component Button "click handler" # Multiple arguments

#Arguments

Templates support positional arguments and slicing:

SyntaxDescription
$1, $2, ...Positional arguments
$@ or $ARGUMENTSAll args joined
${@:N}Args from Nth position (1-indexed)
${@:N:L}L args starting at N

Example:

---
description: Create a component
---
Create a React component named $1 with features: $@

Usage: /component Button "onClick handler" "disabled support"

#Loading Rules

  • Template discovery in prompts/ is non-recursive.
  • For templates in subdirectories, add them explicitly via prompts settings or a package manifest.

ON THIS PAGE

  1. Locations
  2. Format
  3. Argument Hints
  4. Usage
  5. Arguments
  6. Loading Rules
Previous← KeybindingsNextRPC Mode →

Neo Code

Neosantara-first AI coding agent for your terminal.

Product

  • Docs
  • Pricing
  • GitHub

Neosantara

  • Dashboard
  • API

Legal

  • Terms
  • Privacy

2026 Neosantara. All rights reserved.