AI Kitz Labs Dashboard

The open-source marketing operations control center for AI agent teams.

Run CRM, outreach, content, analytics, automation workflows, and the new in-app Coding control center from one dashboard, powered by OpenClaw + SQLite.

---

Alpha Software — AI Kitz Labs Dashboard is under active development. APIs, data models, and configuration behavior can change between releases.

Why AI Kitz Labs Dashboard?

AI Kitz Labs Dashboard is built for operator-led AI marketing systems where you need execution visibility and control, not disconnected tools.

• Marketing system in one place — CRM, outreach, content ops, analytics, experiments, and automations
• OpenClaw-native operations — Dynamic agent/squad discovery, cron templates, workspace and comms surfaces
• Local-first stack — Next.js + SQLite, no required external infra to run locally
• Secure-by-default template posture — Session auth, API key support, host lock, and writeback controls disabled by default
• Production workflow support — Deploy status, auditability, role-based access, and e2e-covered auth/API flows
• Integrated Coding control center — Multi-agent app-development workspace with knowledge files, sessions, autosave, and approval-first planning

Screenshots

Overview

CRM

Quick Start

Requires pnpm — install with npm install -g pnpm or corepack enable.

git clone https://github.com/kitz-labs/AiKitzLabsDashboard.git
cd AiKitzLabsDashboard
pnpm install
pnpm env:bootstrap
pnpm dev

Open http://localhost:3000.

Initial admin access is seeded from AUTH_USER / AUTH_PASS on first run when the users table is empty.

Docker Deploy

• Docker Compose: docker-compose.yml
• Full VPS guide: ops/docker/hostinger-vps-setup.md
• Docker deploy notes: ops/docker/README.md
• Auto-deploy via GitHub Actions: ops/docker/github-actions-auto-deploy.md

The VPS Docker setup pulls the prebuilt image ghcr.io/kitz-labs/aikitz-dashboard:latest and runs standard Next.js production mode on port 3000. The live production env file is ops/docker/kitz-dashboard.env; it stays local/on the VPS and is intentionally not committed to Git.

Install Commands

corepack enable
corepack prepare pnpm@10.30.3 --activate
git clone https://github.com/kitz-labs/AiKitzLabsDashboard.git
cd AiKitzLabsDashboard
pnpm install
pnpm env:bootstrap
pnpm dev

Coding Module

• Coding: New app-internal development control center directly above Settings
• Agent: Multi-agent selection including GitHub Copilot
• API: Multiple provider selection with model and health overview
• Files: Upload and index knowledge files for long-term app memory
• Sessions: Restore, archive, and autosave development context every 30 minutes

Coding Backend Engine

• GET /api/coding/bootstrap: Loads Coding files, sessions, and approval queue
• POST /api/coding/files: Uploads a knowledge file and stores metadata in SQLite
• POST /api/coding/file-changes: Generates a backend diff preview for a workspace file and can create a file-change approval
• GET|POST /api/coding/file-changes/history: Reads file-change history and performs rollback for applied diffs
• GET /api/coding/sessions: Reads persisted Coding sessions
• POST /api/coding/snapshots: Saves a Coding snapshot to the backend
• GET|POST|PATCH /api/coding/approvals: Manages approval-first change requests

File-Change Approvals

• reviewed file path input
• proposed file content draft
• backend-generated diff preview
• approval queue with approve / reject flow
• approved changes can now be applied when KITZ_ALLOW_WORKSPACE_WRITE=true
• rollback and diff history are available for applied coding file changes

Live Mail Workspace

• GET /api/mail/bootstrap: Loads live folders, threads, accounts, and sync timestamp
• GET|POST /api/mail/folders: Lists folders and creates new custom mail folders
• GET|PATCH /api/mail/threads: Lists threads and runs thread actions like archive, trash, star, and move
• POST /api/mail/compose: Sends a new message into the live mail workspace

The Mail page now supports:

• live folders from SQLite-backed backend state
• creating custom folders directly in the UI
• moving, archiving, trashing, and starring threads
• live composer send flow

GitHub Control Page

• New GitHub page directly above Coding in the menu
• Quick links for repo, issues, pull requests, and actions
• Ready-state overview for coding, mail, review, and deployment workflows

Optional backend storage directory:

KITZ_CODING_STORAGE_DIR=./state/coding

Project Status

What Works

• CRM leads, pipeline funnel, source tracking, and engagement APIs
• Outreach sequencing, pause/audit endpoints, and suppression workflows
• Content operations with calendar, item, and performance APIs
• Analytics/KPI views with optional connectors (Plausible, GA4, social)
• Dynamic OpenClaw agent discovery for agents and squads
• Cron jobs/templates with OpenClaw-compatible schedule variants (cron, every, at)
• Deploy status endpoint with OpenClaw config validation preflight
• Session auth + API key auth with role-based access controls

Known Limitations

• Alpha surface area is still evolving; expect occasional schema/UI shifts
• Certain integrations require external provider setup and credentials

Security Considerations

• Change seeded credentials (AUTH_USER, AUTH_PASS, API_KEY) before network deployment
• Keep host lock enabled unless you explicitly need broader access (KITZ_HOST_LOCK=local by default)
• Keep writeback flags disabled unless required:
  • KITZ_ALLOW_POLICY_WRITE=false
  • KITZ_ALLOW_CRON_WRITE=false
  • KITZ_ALLOW_WORKSPACE_WRITE=false
• Never commit real credentials or personal data

Architecture

Layer	Technology
Framework	Next.js 16 (App Router)
UI	React 19 + TypeScript
Data	SQLite (local state in ./state)
Agent Runtime	OpenClaw CLI + filesystem integration
Auth	Session cookie + API key + optional Google OAuth

Configuration

See .env.example for the full list.

Required

• AUTH_USER
• AUTH_PASS (minimum 10 chars)
• API_KEY
• AUTH_COOKIE_SECURE (false for HTTP local dev, true for HTTPS)

OpenClaw / Multi-instance

• KITZ_OPENCLAW_HOME
• KITZ_DEFAULT_INSTANCE
• KITZ_OPENCLAW_INSTANCES (optional JSON array for multi-instance)

Optional 1Password Runtime Overlay

• KITZ_1PASSWORD_MODE=off|auto|required (auto is default behavior)
• KITZ_OP_ENV_FILE=/etc/kitz-dashboard/kitz-dashboard.op.env
• Example mapping: ops/1password/kitz-dashboard.op.env.example

Host Access Lock

• KITZ_HOST_LOCK=local (default)
• KITZ_HOST_LOCK=off
• KITZ_HOST_LOCK=host1,host2

Development

pnpm dev
pnpm build
pnpm typecheck
pnpm lint
pnpm test
pnpm test:e2e

Template Export and Hygiene

Before publishing as a template or sharing broadly:

./scripts/template-audit.sh
./scripts/template-export.sh [output_dir]

Export excludes sensitive/runtime artifacts like .env*, database files, .next, and node_modules.

Open Source

• License: MIT
• Security: SECURITY.md
• Contributing: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Third-Party Notices: THIRD_PARTY_NOTICES.md

License

MIT © 2026 Kitz Labs