Sessions

Persist state across AI conversations

What Sessions Store

Article Content: Title, body, keywords, meta description
Images: Cover image and inline image URLs
Workflow State: Current phase, completed steps
Metadata: Word count, creation date, project info

Session Lifecycle

1. Start: create_content() creates a new session
2. Progress: Tools update session state as work progresses
3. Save: save_content() persists the article to disk
4. Publish: publish_content() sends to CMS
5. Clear: Session is removed after successful publish

Session Storage

~/.suparank/
├── session.json              # Active session
└── content/
    └── 2024-01-15-my-article/
        ├── article.md        # Markdown content
        ├── metadata.json     # Article metadata
        └── workflow.json     # Workflow state

Resuming Work

If your conversation is interrupted, start a new one and call get_session() to see your current state and continue where you left off.