Veritas Kanban

Abstract

1. Introduction

Start with a visual Kanban board. Add CLI, MCP, OpenClaw, Squad Chat webhooks, workflows, or governance only when you need that layer.

⭐ If you find this useful, star the repo — it helps others discover it!

Start with the local board. OpenClaw, MCP, Squad Chat webhooks, notifications, workflows, and governance gates are optional layers you can turn on later. See Setup Paths for the board-only, CLI, MCP, OpenClaw, and self-hosted paths.

2. Objective

Lightweight orchestration harness built for your AI agents. The unfiltered truth about where your project stands.

This project demonstrates how TypeScript, React can be applied to a real-world Blockchain & Cloud Computing problem.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/BradGroux/veritas-kanban.git
cd veritas-kanban

1. OpenClaw gateway or browser relay
2. MCP write access
3. Squad Chat webhook or external wake behavior
4. Notification delivery channels
5. Workflow gates or governance policies

Clone and set up veritas-kanban locally using the board-only setup path first. Install dependencies with pnpm, copy server/.env.example to server/.env, and start the dev server. Verify the UI at localhost:3000 and the API health endpoint at localhost:3001/api/health. Do not configure OpenClaw, MCP, Squad Chat webhooks, workflows, or notifications unless I explicitly ask for that layer.

brew tap BradGroux/tap
brew install --cask veritas-kanban

git clone https://github.com/BradGroux/veritas-kanban.git
cd veritas-kanban
pnpm install
cp server/.env.example server/.env   # Edit to change VERITAS_ADMIN_KEY
pnpm dev

vk setup                         # Guided environment check + sample task
vk setup --skip-task             # Check only, no sample task
vk setup --json                  # Machine-readable output
vk doctor                        # Redacted setup health report
vk doctor --json                 # Support-safe JSON report
vk snapshot --format markdown    # Redacted runtime support snapshot
vk prompts import prompt-registry --dry-run
vk sqlite journal status --json  # Journal maintenance and override posture
vk tool-servers list --json      # Registered run-scoped MCP servers
vk tool-servers discover <id>    # Refresh version-bound tool discovery

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add a CI/CD pipeline with GitHub Actions
• Deploy to a public test network or cloud free tier
• Add monitoring and cost alerts

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Why does this problem need a blockchain or cloud-native design?
2. Explain the smart contract / infrastructure components and how they interact.
3. How are gas costs or cloud costs kept under control?
4. How is the system secured (keys, IAM, access control)?
5. How would the solution scale to many more users?

9. Source Code & License

This project is developed by BradGroux and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.