ai assistant guide

Get Key

Everyday Assistant Integration

talk to your ai, save to dreamcaster

You do not need to be a developer to connect your AI assistant. You can speak or type your dreams to Google Gemini, Claude, or ChatGPT in the morning, and your AI will interpret them and automatically log them into your private Dreamcaster journal.

1Get your key

Generate your connection key in Settings.

2Paste setup prompt

Copy the ready-to-use prompt for your AI below and paste it once.

3Talk upon waking

Say “I had a dream about...” to interpret and auto-save.

This key is personal and non-transferable. Use it only in an assistant you control. Do not send it in messages or commit it to a repo. If it may have leaked, rotate or disconnect it in Settings. Pasting it here only fills the templates on this device.

Google Gemini Setup (30 Seconds)

Works on the Gemini mobile app, Gemini Live voice conversations, or at gemini.google.com.

  1. Open Gemini on your phone or web browser.
  2. Start a new chat (or create a custom Gem called Dreamcaster).
  3. Copy the personalized prompt below and paste it into your chat:
You are my personal Dreamcaster subconscious companion.
When I share a dream or morning recall with you:
1. Interpret the dream with psychological depth across symbolic, archetypal, and emotional dimensions.
2. Save this dream to my private Dreamcaster journal by making an HTTP POST request to:
   https://dreamcaster.xyz/api/agents/v1/interpret
   Headers:
     Authorization: Bearer dc_live_YOUR_KEY
     Content-Type: application/json
   Body:
     {"description": "<my dream narrative>"}
3. If I ask about my recurring dream themes or motif history, search my journal at:
   https://dreamcaster.xyz/api/agents/v1/memory?q=<keyword>
   Headers:
     Authorization: Bearer dc_live_YOUR_KEY

Confirm you are ready by greeting me and asking what I dreamed about last night.
What to say to Gemini next:

“I woke up from a dream where I was swimming through a sunlit cave and discovered a glowing compass underwater.”

The Sovereign Scribe Principle & Privacy Boundaries

On Dreamcaster’s side, your dreams are never sold and never used to train models—and setting a dream to Private via your agent hides it from all public feeds.

Important distinction: When you dictate a dream to an external AI (Grok, ChatGPT, Claude, Muse, Dot), that company processes and stores your conversation on their servers under their own data and training policies. When you want zero external AI chat middlemen, hardware-backed Passkey Vault isolation, and Local Offline Vault recording, log sensitive dreams directly inside the native Dreamcaster app.