Persistence CLI

CLI commands for database persistence

Persistence CLI

Command-line interface for database persistence management.

Installation

pip install "praisonai[tools]"

Commands

Help

praisonai persistence --help

Doctor

Validate database connectivity.

praisonai persistence doctor [options]

Options:

Option	Description
--conversation-url URL	Conversation store URL
--knowledge-url URL	Knowledge store URL
--state-url URL	State store URL
--all	Test all configured stores

Example:

praisonai persistence doctor \
    --conversation-url "postgresql://postgres:pass@localhost/db" \
    --knowledge-url "http://localhost:6333" \
    --state-url "redis://localhost:6379"

Run

Run an agent with persistence.

praisonai persistence run [options] "prompt"

Options:

Option	Description
--session-id ID	Session identifier
--user-id ID	User identifier (default: “default”)
--conversation-url URL	Conversation store URL
--knowledge-url URL	Knowledge store URL
--state-url URL	State store URL
--agent-name NAME	Agent name (default: “Assistant”)
--agent-instructions TEXT	Agent instructions
--dry-run	Show config without running

Example:

praisonai persistence run \
    --session-id "my-session" \
    --conversation-url "postgresql://localhost/db" \
    "Hello, my name is Alice"

Resume

Resume an existing session.

praisonai persistence resume --session-id ID [options]

Options:

Option	Description
--session-id ID	Session to resume (required)
--conversation-url URL	Conversation store URL
--show-history	Display conversation history
--continue "prompt"	Continue with new prompt

Example:

# Show history
praisonai persistence resume \
    --session-id "my-session" \
    --conversation-url "postgresql://localhost/db" \
    --show-history

# Continue conversation
praisonai persistence resume \
    --session-id "my-session" \
    --conversation-url "postgresql://localhost/db" \
    --continue "What's my name?"

Environment Variables

Variable	Description
PRAISON_CONVERSATION_URL	Default conversation store URL
PRAISON_KNOWLEDGE_URL	Default knowledge store URL
PRAISON_STATE_URL	Default state store URL
OPENAI_API_KEY	OpenAI API key for agent

export PRAISON_CONVERSATION_URL="postgresql://localhost/db"
export OPENAI_API_KEY="your-key"

# Now commands are simpler
praisonai persistence doctor --all
praisonai persistence run --session-id "my-session" "Hello!"

Troubleshooting

Connection refused:

• Check Docker containers are running
• Verify URL format and credentials

No API key:

• Set OPENAI_API_KEY environment variable