Skip to main content
Every project gets its own conversation history, automatically.

​
Quick Start

1

From your project root

Start working in any project directory:
cd ~/code/my-app && praisonai run "Build a TODO app"
Project context is automatically detected from the git root or current directory.
2

Continue tomorrow, from the same folder

Return to the same project to pick up where you left off:
praisonai run --continue "Add a delete endpoint"
Session continuity works seamlessly across days and terminal sessions.
3

List this project's sessions

See all sessions for the current project:
praisonai session list
Only sessions from this project are shown by default.

​
How project detection works

Where you areProject ID derived from
Inside a git repogit rev-parse --show-toplevel (the repo root)
Outside a git repoThe current working directory
The hash itselfFirst 8 chars of sha256(absolute_path)
The project ID ensures consistent session scoping regardless of your current subdirectory within the project.

​
How --continue finds your session

If no previous session exists, a warning is shown and a new session starts automatically.

​
Common Patterns

​
Resume after lunch

Pick up exactly where you left off: 
praisonai run --continue "Now let's add error handling"

​
Branch a session to try something risky

Experiment without affecting the original conversation: 
praisonai run --fork --session abc123 "What if we used GraphQL instead?"
Both the original and forked sessions evolve independently.

​
One-off question I don’t want remembered

Ask quick questions without cluttering project history: 
praisonai run --no-save "What's the capital of France?"

​
Best Practices

Always start praisonai run from your project’s root directory so the git root is detected correctly. This ensures consistent project identification regardless of your current subdirectory.
# Good: from project root
cd ~/code/my-app
praisonai run --continue "Add tests"

# Still works: from subdirectory (same project detected)
cd ~/code/my-app/src
praisonai run --continue "Add tests"
When exploring alternatives, fork the session rather than continuing in the main conversation thread:
# Fork to try different approach
praisonai run --fork --session abc123 "try Redis instead of PostgreSQL"

# Original session remains intact
praisonai run --session abc123 "continue with PostgreSQL implementation"
For quick questions or sensitive information that shouldn’t be stored:
praisonai run --no-save "How do I hash this password: secretPassword123"
Periodically review and delete old sessions from all projects:
praisonai session list --all
praisonai session delete old-session-id

Run Command

Complete praisonai run documentation with session flags

Session Management

Session commands and storage backends