AI Instructions

Instructions are directives that your AI assistant reads at the start of every session. When your AI assistant calls get_context or get_rules, active instructions are returned sorted by priority. Your AI assistant follows them as project-specific directives.

How They Work

1. You create instructions in Settings > AI Instructions (or via API / AI tools)
2. When your AI assistant starts a session, it calls get_context
3. Active instructions are returned sorted by priority (higher = first)
4. Your AI assistant reads and follows them throughout the session

Example Instructions

• Always write tests for new features before marking a task complete
• Use TypeScript strict mode — no any types
• When creating tasks, always include a plan with checkboxes
• Log activity after every completed task with a summary of what changed
• Priority: urgent items first, then by due date
• Prefer pnpm over npm for all package operations

Instruction Properties

• content — The instruction text your AI assistant will follow
• priority — Sort order. Higher priority rules are shown first (default: 0)
• isActive — Toggle an instruction on/off without deleting it

Managing via API

# Create a rule
curl -X POST "https://taskjunky.app/api/rules" \
  -H "X-API-Key: tj_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Always log activity after completing a task", "priority": 10 }'

# List active rules
curl "https://taskjunky.app/api/rules" \
  -H "X-API-Key: tj_your_key"

Managing via AI Tools

get_rules()                    → Returns all active rules
create_rule({ content: "...", priority: 5 })
update_rule({ id: "...", isActive: false })  → Disable a rule