YAML Metadata Warning:empty or missing yaml metadata in repo card
Check out the documentation for more information.
What This Is
SnapKitty Bot brings all 11 sovereign agents into Discord. Ask any agent a question, manage money pools, check your fundability tier, read the live Bifrost audit trail — all from slash commands.
This is a standalone Express server that receives Discord interactions via webhook. It connects to the same Neon PostgreSQL database as the main SnapKitty OS and routes /ask queries through the Ollama-powered reasoning engine at collectivekitty.com.
Commands
| Command | What it does |
|---|---|
/ask [agent] [message] |
Route any question to any of the 11 agents |
/pool create |
Create a named money pool |
/pool list |
See all active pools and balances |
/pool fund |
Add capital to a pool |
/pool close |
Archive a pool |
/tier |
Current fundability tier status and blockers |
/agents |
Full agent directory in plain English |
/status |
System health — Bifrost, DB, infrastructure |
/seal |
Last decision seal hash |
/audit |
Last 5 Bifrost events with risk scores |
/merkle |
Merkle root and WORM chain entry count |
The 11 Agents
| Agent | Key | Domain |
|---|---|---|
| RELAY | bridge |
Human-Machine Bridge — start here |
| AXIOM | finance |
GL · Triple-Entry · Money Pools |
| VAULT | treasury |
Reserves · Payments · Veto authority |
| NEXUS | crm |
Pipeline · Deals · Forecast |
| FORGE | procurement |
Vendors · POs · Spend |
| HERALD | bifrost |
Event Routing · Traces |
| TENSOR | ml |
Risk Scoring · Anomaly Detection |
| SENTINEL | risk |
Compliance · Threat Score |
| LEDGE | auditor |
WORM Ledger · Audit Chain |
| ATLAS | operator |
Health · Tier gate authority |
| QUILL | scriptwriter |
Reports · Decks · Copy |
Setup
1. Clone and install
git clone https://github.com/SNAPKITTYWEST/myapplication.git
cd myapplication
npm install
npx prisma generate
2. Configure environment
cp .env.example .env
Fill in .env:
DISCORD_PUBLIC_KEY= # from Discord Developer Portal → your app → General Information
DISCORD_APP_ID= # same page
DISCORD_BOT_TOKEN= # Bot → Token
DATABASE_URL= # Neon PostgreSQL connection string
SNAPKITTY_API_URL=https://collectivekitty.com
PORT=3001
3. Register slash commands (once)
npm run register
4. Run the bot
# Development
npm run dev
# Production
npm run build && npm start
5. Connect to Discord
In the Discord Developer Portal:
- Go to General Information → set Interactions Endpoint URL to your server:
https://your-domain.com/interactions - Discord will verify the endpoint with a PING. If it responds with PONG, you're live.
For local development, use ngrok or Cloudflare Tunnel to expose localhost:3001.
Architecture
Discord → POST /interactions
│
├── verifyKey() — Ed25519 signature validation
│
├── /ask → askAgent() → Ollama at collectivekitty.com → reply
├── /pool → Prisma → Neon PostgreSQL → reply
├── /tier → Prisma → live deal/vendor/pool counts → reply
├── /status → Prisma → Bifrost event counts → reply
├── /seal → Prisma → last BifrostEvent → reply
└── /audit → Prisma → last 5 BifrostEvents → reply
The bot validates every Discord request with Ed25519 before processing. Unauthenticated requests are rejected with 401.
Part of the SnapKitty Fortress
This bot is the Discord interface layer of the SnapKitty Sovereign OS.
The full system lives in DEVFLOW-FINANCE:
- Rust core with SHA-256 WORM ledger and 5-tier state machine
- Next.js War Room where agents think out loud in real time
- Bifrost event pipeline, Plaid banking, Stripe Issuing
- Local Ollama LLM reasoning (no OpenAI dependency)
SnapKitty Sovereign OS — built in the open, proven in chain.