Skip to main content

Never lose your AI chats or work again. Local-first session persistence with optional cloud sync.

Project description

StartQ

Never lose your AI chats or work again.

Every time you start a new AI agent session, you repeat yourself. You re-explain the project. You re-paste the context. You hope the agent remembers what happened yesterday.

It usually doesn't.

StartQ fixes that.

Why This Matters — A Real Story

On May 19, 2026, Antigravity IDE pushed an update that wiped environment state for developers mid-session. Workflows deleted. Context gone. Developers across the platform lost hours of work.

I didn't lose a single thing.

Because StartQ had already persisted my session state, agent context, and workflow definitions to local memory before the update hit. When the environment came back up, I ran startq boot, and everything was exactly where I left it — 28 workflow files, all agent configurations, full session history.

StartQ is insurance for your AI workflow. Your context survives IDE crashes, model swaps, environment resets, and cloud outages.

60-Second Install

pip install startq

Initialize your local memory (Brain) in your project directory:

startq init

Boot your agent workflow:

startq boot

When you are finished with your session, sync the persistent memory:

startq end -c "Finished refactoring the database schemas."

How It Works

Session 1                          Session 2
─────────                          ─────────
You work with AI agent             You start a NEW agent session
    │                                  │
    ▼                                  ▼
startq end -c "summary"           startq boot
    │                                  │
    ▼                                  ▼
State written to .startq/brain/    State loaded from .startq/brain/
    │                                  │
    ▼                                  ▼
SHA-256 signed receipt             Signature verified ✓
                                       │
                                       ▼
                                   Agent has FULL context
                                   from Session 1. No amnesia.

Features

  • Local First: Your Brain is a local JSON directory (.startq/brain/). No cloud dependencies, no lock-in.
  • Cryptographic Integrity: Every session receipt is SHA-256 signed. Tampering is detected on boot.
  • Universal Agnosticism: Point any agent (Claude Code, Cursor, Antigravity, Gemini CLI, or custom scripts) to .startq/ to share context across sessions.
  • Daemons (Systemd for AI): Add scripts to .startq/config.json under "daemons", and StartQ will spawn them as detached background runners on boot.
  • Git State Capture: startq end automatically snapshots your current branch and uncommitted files — so the next session knows exactly where you left off.
  • Zero Dependencies: Pure Python standard library. No pip packages. No curl. No YAML.

What Gets Persisted

Data Where Format
Session context .startq/brain/<uuid>.json Signed JSON
Git branch + dirty files Inside session receipt Embedded
Agent identity .startq/config.json JSON
Init state .startq/state.json JSON

The Problem StartQ Solves

AI agents have no memory between sessions. Every new chat is a blank slate. This means:

  • You re-explain your project structure every time
  • You lose the decisions made in previous sessions
  • An IDE update or crash wipes your workflow context
  • Context windows fill up re-establishing what was already known

StartQ gives your agents a persistent local brain that survives across sessions, across tools, and across crashes.

License

MIT License. Built in Seattle by Phil Hills.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

startq-0.2.0.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

startq-0.2.0-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file startq-0.2.0.tar.gz.

File metadata

  • Download URL: startq-0.2.0.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for startq-0.2.0.tar.gz
Algorithm Hash digest
SHA256 54b6988e9561262401e7f521616c0c4545d3f05a560ed7b2c4b586709b78f6fa
MD5 3702aea9216006820890dcae697a5dc2
BLAKE2b-256 38feedd553019ba901c6515221047dc862214687977361861ab8d3bfcd3382e3

See more details on using hashes here.

File details

Details for the file startq-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: startq-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 11.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for startq-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1a1568d589a6f1f21bdb983a0d23ea550791f1da736ec881af445826d0deffd3
MD5 d82e5d6dac54d56936abe7dc03501d9c
BLAKE2b-256 a1d34c625f3d7d3fbf93a0f74a179dbee0f6af7c60c670c2e14742fedc025684

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page