Skip to content
FunCoding

caspian-connect-email

Connect Caspian email for OpenCode: ensure credentials (sandbox or dashboard API key), write caspian.env, connect inbox, enable email in caspian.json. Use when the user wants to link email, set up the agent inbox, or runs /caspian:connect-email.

Star
975
Category
Data
License
AGPL-3.0
Last commit
Aug 25, 2026

packages/opencode/src/skills/caspian-connect-email/SKILL.md

View on GitHub

Caspian connect email

Get a Caspian API key (sandbox or existing dashboard key), save it to ~/.config/opencode/caspian.env, connect an email inbox, and enable email in caspian.json channels.

When to use

  • User asks to connect / set up Caspian email
  • User runs /caspian:connect-email or /caspian-connect-email
  • First-time OpenCode + Caspian setup

How

  1. Call caspian_setup_credentials with mode=status.

  2. If not configured, ask the user which path they want (do not invent keys):

    A — Instant sandbox (recommended for trying Caspian)
    No account. Call caspian_setup_credentials with mode=sandbox.
    Writes CASPIAN_API_KEY + CASPIAN_BASE_URL=https://api.trycaspianai.com to ~/.config/opencode/caspian.env (and project .env).

    B — Existing Caspian account
    Tell them to sign in at https://dashboard.trycaspianai.com/login , open a project, copy the API key, then call caspian_setup_credentials with mode=paste and apiKey=<their key>.

    If setup says RESTART REQUIRED, stop and tell them to quit + relaunch OpenCode, then run /caspian:connect-email again.

  3. Call caspian_connections (optional) to show current links.

  4. Call caspian_connect_email (optional displayName).

  5. If the tool says RESTART REQUIRED, tell the user clearly:

    Restart OpenCode (quit and relaunch) so the plugin reloads caspian.json and admit includes email.

  6. Do not invent connection ids or addresses. Report tool errors as-is.

Notes

  • Secrets go in caspian.env / .env — never in caspian.json or chat logs when you can avoid it (the tool masks keys in its output).
  • CLI (caspian init) is optional; sandbox mint and paste cover the same APIs.
  • After restart, inbound email should create OpenCode sessions automatically.

Similar Skills

agentic-os

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

health

GAgarrytan/gstack136k883 new stars in the last 7 days

deprecation-and-migration

ADaddyosmani/agent-skills106k3,628 new stars in the last 7 days

Official

flowai-live-dashboard-template

NEnexu-io/open-design101k1,126 new stars in the last 7 days

Official

dashboard

NEnexu-io/open-design101k1,126 new stars in the last 7 days

cloud-sync

THthedotmack/claude-mem100k3,024 new stars in the last 7 days