Readme
Intent-Engine
中文 | English
AI forgets. You shouldn't have to remind it.
The Problem
Every new session with an AI assistant:
Day 1 : " Let's build authentication"
AI works brilliantly, makes smart decisions...
[ session ends]
Day 2 : " Continue authentication"
AI : " What authentication? I have no memory of this."
AI has powerful reasoning. It just can't remember.
The Solution
cargo install intent-engine
Now your AI remembers everything — across days, weeks, months.
Day 1 : " Let's build authentication"
AI creates task, works, records decisions → saved to disk
Day 2 : " Continue authentication"
AI reads memory → " Resuming... we chose JWT with HS256,
finished token generation, next: OAuth integration"
No cloud. No config. Just persistent memory.
How It Works
Intent-Engine gives AI a simple protocol:
ie status # What am I working on?
ie plan # Create or update tasks (JSON stdin)
ie log decision "..." # Record why I made this choice
ie search "auth" # Find relevant history
When AI starts a session, it runs ie status . Everything comes back:
Current task and its context
All ancestor tasks (the bigger picture)
Decision history (the "why" behind every choice)
One command. Full context restoration.
Integration
Claude Code (One-Click)
claude plugin marketplace add wayfind/origin-task
claude plugin install intent-engine
That's it. The plugin automatically:
Runs ie status at every session start
Auto-installs ie CLI via npm if not found
Guides Claude to use ie plan instead of TodoWrite
Manual Install
If you prefer manual setup:
# 1. Install binary (choose one)
cargo install intent-engine
# or: brew install wayfind/tap/intent-engine
# or: npm install -g @origintask/intent-engine
# or (no Rust needed): curl -fsSL https://raw.githubusercontent.com/wayfind/intent-engine/main/scripts/install/ie-manager.sh | bash -s install
# 2. Add system prompt
claude --append-system-prompt "Use ie plan instead of TodoWrite. Commands: ie status, echo '{...}'|ie plan, ie log, ie search"
Other AI Assistants
Any AI with CLI access can use ie commands directly.
The Deeper Idea
Most tools track what happened (commits, logs, events).
Intent-Engine tracks what you intended and why .
Git: " Changed auth.rs line 42"
Intent- Engine: " Chose JWT over sessions for stateless API scalability"
Code changes. Intent persists.
Core Features
Hierarchical tasks — break big goals into smaller ones
Decision history — every "why" recorded with context
Cross-session memory — pick up where you left off
Local storage — everything in ~/.intent-engine/ , no cloud
Dashboard UI — visualize progress at localhost: 11391
Quick Reference
# Install
cargo install intent-engine
# or: brew install wayfind/tap/intent-engine
# or: npm install -g @origintask/intent-engine
# or: curl -fsSL https://raw.githubusercontent.com/wayfind/intent-engine/main/scripts/install/ie-manager.sh | bash -s install
# Core commands
ie status # Current context
ie search "todo doing" # Find unfinished work
echo '{"tasks":[...]}' | ie plan # Create/update tasks
ie log decision "chose X" # Record decision
ie dashboard open # Visual UI
Documentation
License
MIT OR Apache-2.0, at your option.
Give your AI the memory it deserves.
cargo install intent-engine