Command Reference
Complete reference for all Tenax commands. All commands use the /tenax: namespace.
Status & Info
Show Tenax status and quick summary. Displays total sessions, decisions, patterns, tasks, insights, recent activity, and storage size.
Use when: You want a quick overview of accumulated project knowledge.
Show detailed statistics about Tenax including timeline, sessions per month, top topics, and storage breakdown.
Use when: You want analytics on your project history and memory usage patterns.
List all stored sessions with metadata including session ID, date, summary, token count, and decision count.
Use when: You want to browse all past sessions and their contents.
Loading Sessions
Load a specific session by ID into context. Shows full session details including decisions, patterns, files modified, and topics.
| Argument | Description |
|---|---|
session-id | Session ID (e.g., "5" or "005") |
Example: /tenax:load-session 003
Load multiple sessions by IDs. If no IDs specified, loads the last 3 sessions. Use --recent N to load N recent sessions. Respects token budget.
| Argument | Description |
|---|---|
IDs | Session IDs (comma or space separated) |
--recent N | Load N most recent sessions |
-b, --budget | Token budget limit |
Examples:
/tenax:load-sessions 001,002,003- Load specific sessions/tenax:load-sessions --recent 5- Load 5 most recent sessions/tenax:load-sessions- Load last 3 sessions (default)
Recording Knowledge
Manually save the current session to Tenax. Reviews conversation for decisions, patterns, tasks, and insights.
Use when: You want to checkpoint important knowledge mid-session.
Manually record a decision, pattern, task, or insight.
Record a Decision
Example: /tenax:record decision -t database "Using PostgreSQL" -r "Team expertise"
Record a Pattern
Example: /tenax:record pattern -n error-handler "Wrap async routes in try-catch"
Record a Task
Example: /tenax:record task "Add unit tests" -p high
Record an Insight
Example: /tenax:record insight "Rate limits are per-user not per-app"
Searching
Search across all Tenax using semantic similarity. Returns ranked results with similarity scores and snippets.
| Argument | Description |
|---|---|
query | Natural language search query (required) |
-t, --type | Filter by type: decision, pattern, task, insight, session |
-l, --limit | Maximum results (default: 10) |
Examples:
/tenax:search "authentication approach"/tenax:search "database" -t decision/tenax:search "error handling" -l 5
Management
View or modify Tenax settings including token budget, auto-load behavior, and recording preferences.
See Settings Reference for all available options.
Remove entries from Tenax. Confirmation required for bulk deletions.
| Argument | Description |
|---|---|
id | Delete specific entry by ID |
--type | Delete all of type: decisions, patterns, tasks, insights |
--all | Delete everything (requires confirmation) |
Use when: You need to clean up obsolete or incorrect entries.
Add or remove tags from sessions for organization.
Examples:
/tenax:tag 003 auth feature- Add tags/tenax:tag 003 auth --remove- Remove tag
Export & Backup
Export Tenax to various formats: Markdown, JSON, Obsidian, or Notion.
| Argument | Description |
|---|---|
-f, --format | Export format: markdown (default), json, obsidian, notion |
-o, --output | Output directory |
-s, --sessions | Include full session data |
Examples:
/tenax:export- Export to Markdown/tenax:export -f obsidian -o ./vault- Export to Obsidian vault
Create a backup of all Tenax data as a JSON file with base64-encoded contents.
Use when: You want to safeguard Tenax before major changes or share between machines.
Restore Tenax from a backup file. Asks for confirmation if memory already exists.
| Argument | Description |
|---|---|
backup-file | Path to backup file (required) |
-f, --force | Overwrite without confirmation |
Use when: You need to recover from accidental deletions or transfer to a new machine.