KumoKodo.ai Case Study
Building Kodokyo
How we built an AI-native project operating system that replaces Slack, Jira, and Asana in a single platform—with agentic AI, real-time messaging, video huddles, and 57+ shipped features across 52 database tables.
The Challenge
Agencies and remote teams are drowning in tool fragmentation. Decisions happen in Slack, status updates live in Jira, plans sit in Asana, and documentation rots in Google Docs. The result: 5+ hours per team member per week lost to context switching, information silos, and documentation that's always stale. We analyzed each tool's failures and set out to solve all of them in one platform.
What's Wrong with Slack
Communication without context
- Conversations are disconnected from the work they reference — decisions vanish into scroll-back
- No task management — teams copy-paste action items into separate tools, losing attribution
- Per-user pricing ($8.75+/user/mo) makes adding contractors and guests a budget decision
- No client-facing portal — agencies create separate guest channels that leak internal context
- No built-in video with recording/transcription — requires Zoom or Google Meet as yet another tool
What's Wrong with Jira
Complexity that slows teams down
- Overly complex configuration — custom workflows, schemes, and permission systems require a dedicated admin
- No real-time messaging — comments are async-only, forcing teams back to Slack for quick decisions
- Rigid task views — board and backlog only; no Timeline/Gantt, Calendar, or Live Document views
- No client portal — clients can't view progress or approve deliverables without a Jira license
- AI features are bolted-on afterthoughts, not native agentic tools that take real actions
What's Wrong with Asana
Project management without depth
- No real-time chat — task comments don't replace the need for a messaging tool, so teams still need Slack
- No time tracking built in — requires third-party integrations like Harvest or Toggl
- No video calls or huddles — scheduling still requires external tools
- Per-user pricing ($10.99+/user/mo) at scale makes enterprise adoption prohibitively expensive
- No automations engine with webhooks — limited rule triggers and no custom inbound/outbound integrations
How Kodokyo Fixes Every Pain Point
Our Solution
Kodokyo is an AI-native project operating system built for agencies and remote teams. Every feature was designed from scratch to eliminate tool switching and put AI at the center of how work gets done.
Agentic AI with Tool Use
Powered by Anthropic Claude with 8 server-side tools. The AI assistant "Kodo" doesn't just answer questions — it creates tasks, manages teams, sends invites, and updates statuses through natural conversation. A stream-first architecture with up to 5 tool-use rounds ensures low-latency responses.
- AI task generation from project descriptions
- Zero-input daily standups from activity logs
- AI project health checks and daily briefings
- Context-aware suggestions per page
- Message-to-task extraction with one click
- AI-generated Living Documents from task data
Slack-Grade Messaging
Full real-time messaging powered by Ably WebSockets. Channels scoped to organizations, clients, projects, tasks, and DMs. Every conversation is anchored to the work it concerns — no more searching through disconnected chat threads.
- Threaded replies with emoji reactions
- Typing indicators and online/away/offline presence
- Pinned messages, bookmarks, and Save for Later
- @mentions with autocomplete and notifications
- Full-text message search across all channels
- File sharing with Cloudflare R2 storage
9 Task Views + Sprint Planning
Full project management with Kanban, List, Board, Timeline/Gantt, Calendar, Dashboard, Messages, Sprints, and Live Document views. Drag-and-drop reordering, subtasks, dependencies, recurring tasks, custom fields, and sprint planning with velocity tracking.
- Sprint lifecycle: planning → active → completed
- Custom fields per project (text, number, date, select, checkbox)
- Recurring tasks with auto-creation on completion
- Section-based task grouping with colors
- Bulk operations (move, assign, status change)
- Task activity audit trail with cursor pagination
Video Huddles with Recording & Transcription
LiveKit-powered WebRTC huddles with audio, video, screen sharing, and in-huddle chat. Huddles can be recorded to MP4 via LiveKit Egress, transcribed with Deepgram Nova-2 (speaker diarization), and recap emails sent automatically to all participants.
- AI meeting summary on huddle end
- Deepgram transcription with speaker timestamps
- Post-huddle recap emails via Resend
- Popup window UI with BroadcastChannel sync
Client Management & Portal
Full client CRM with per-client billing rates, project scoping, and activity tracking. The token-based client portal lets clients view progress, approve deliverables, rate satisfaction, and submit new projects via intake forms — all without needing an account.
- Project intake forms with AI task scaffolding (8-15 tasks)
- Client satisfaction tracking with 1-5 star ratings
- Approval workflows with accept/reject and notes
- Configurable portal access with token expiration
Billing, Automations & Integrations
Full Stripe integration with checkout, billing portal, webhook processing, and 3-tier subscription management. A rules-based automations engine with 5 triggers and 6 actions. Plus GitHub, GitLab, Figma, Google Calendar, and custom webhook integrations.
- Stripe subscriptions with 14-day free trial
- Platform admin dashboard for cross-org management
- Automation execution logs with anti-loop protection
- Custom inbound/outbound webhooks with signing secrets
Technical Deep Dive
Frontend Stack
Next.js 16 with App Router, React 19, and TypeScript. Three isolated route groups (marketing, app, portal) with independent layouts. 10 Zustand stores for state management with zero prop drilling.
- shadcn/ui with Radix primitives (new-york style)
- Tailwind CSS 4 with OKLCH accent color system
- Tiptap 3 rich text editor for Live Documents
- Recharts for analytics and reporting dashboards
- @dnd-kit for drag-and-drop task reordering
- cmdk command palette with global keyboard shortcuts
Backend & Infrastructure
110+ API endpoints deployed on Vercel serverless functions. Neon PostgreSQL with Drizzle ORM for type-safe database access. Cloudflare R2 for S3-compatible object storage with presigned URLs.
- Auth.js v5 with JWT sessions and Google OAuth
- Ably for all real-time: chat, presence, typing
- LiveKit Cloud for WebRTC video huddles + Egress recording
- Deepgram Nova-2 for huddle transcription with speaker diarization
- Stripe for subscriptions, checkout, billing portal, webhooks
- Resend for transactional email and huddle recap delivery
- Centralized permission system with role-based maps
- JSONB configs for flexible automation rules
AI Architecture
Stream-first architecture using Anthropic Claude with native tool_use. The AI streams initial responses for low-latency Q&A, detects tool_use stop reasons, executes tools server-side (max 5 rounds), then streams the final response.
- 1.lookup_entities — resolve names to UUIDs
- 2.create_task / update_task / list_tasks — full task CRUD
- 3.add_team_member / remove_team_member — team management
- 4.create_team — organizational scaffolding
- 5.invite_member — send email invitations
Database Design (52 Tables)
Neon PostgreSQL with Drizzle ORM. Multi-tenant architecture with organization-scoped data isolation. Key domain areas:
- Auth & Users — accounts, sessions, OAuth links, super admin
- Organizations — members, invites, teams, 4-tier roles
- Clients & Projects — CRM, budgets, billing rates, sections
- Tasks — status lifecycle, dependencies, recurrence, sprints, custom fields
- Documents — living documents, version history, AI proposals
- Chat — channels, messages, reactions, threads, pins, saved messages
- Huddles — sessions, participants, chat, recordings, transcriptions
- Automations & Integrations — rules, execution logs, external links
- Client Portal — tokens, comments, approvals, satisfaction ratings
- Time Tracking & Working Hours — entries, timers, per-user schedules
Key Features
AI Chat Panel
Floating, draggable, resizable AI panel with streaming responses. Context-aware — knows which page, project, client, or team the user is viewing. Persists position and size via localStorage.
Living Documents
Per-project AI-maintained documents with change proposals, version history, and auto-generation from task data. Documentation that never goes stale.
Automations Engine
5 triggers and 6 actions with JSONB configs. Anti-loop protection, execution logging, and custom webhook support for external integrations.
Time Tracking
Live timer widget, manual entries, billable/non-billable flags. Per-client billing rates with project budget tracking and hour caps.
Multi-Tenant Orgs
4-tier role system (Owner, Admin, Member, Guest) with project-level roles. Email invitations with 7-day expiry and guest scoping to specific resources.
Centralized Permissions
Role-to-permission maps replace scattered inline checks. AI tool executors mirror API route permission checks for consistent authorization.
Huddle Recording & Transcription
Record huddles to MP4 via LiveKit Egress. Transcribe with Deepgram Nova-2 speaker diarization. Auto-send recap emails with transcript preview to all participants.
Integrations
GitHub, GitLab, Figma, and Google Calendar integrations. Custom inbound/outbound webhooks with signing secrets for secure automation.
Smart Notifications & Focus Mode
Priority-grouped notifications (Urgent, Important, Earlier) with smart scoring. Focus Mode/DND with configurable durations, countdown timer, and auto-status.
Sprint Planning & Velocity
Time-boxed sprints with planning/active/completed lifecycle, goal tracking, velocity display (avg tasks/sprint), dedicated board view with mini kanban columns.
Workload Heatmap
GitHub-style activity heatmap showing task completions and hours tracked per team member. Load indicators (Overloaded/Heavy/Moderate/Light) with interactive tooltips.
Command Palette & Shortcuts
Universal Cmd+K palette with quick actions, global search, inline task creation, recent items, and theme toggle. Global keyboard shortcuts for navigation across all pages.
Results & Metrics
For Teams
- Unified workspace — chat, tasks, docs, video, and time tracking in one tab
- AI handles task creation, prioritization, and status updates via natural conversation
- Auto-generated standup reports with zero manual input — pulls from activity and time entries
- Smart notification grouping (Urgent/Important/Earlier) reduces alert fatigue
- Focus Mode with DND and countdown timer prevents context-switching
- Cmd+K command palette with global search, quick actions, and keyboard shortcuts
- Working hours and timezone settings for distributed team coordination
- Sprint planning with velocity tracking and burndown visualizations
For Agencies
- Client portal with token-based access — no client accounts needed
- AI generates 8-15 tasks from client project intake forms automatically
- Profitability reporting with revenue vs. cost per client/project
- Client satisfaction tracking with 1-5 star ratings and feedback
- Team-based pricing scales without per-seat cost anxiety
- Full client CRM with per-client billing rates and billing summaries
- Huddle recordings with Deepgram transcription and recap emails to clients
- Project templates — save and reuse structures across clients
Lessons Learned
AI tool-use needs permission mirroring
Every AI tool executor must replicate the same permission checks as the corresponding REST API route. We built a centralized permission system early, which made this straightforward instead of a security nightmare.
Real-time is table stakes, not a feature
Designing for Ably WebSocket channels from day one meant presence, typing indicators, and live updates came naturally. Retrofitting real-time onto existing architecture would have been a multi-month project.
Route groups save your sanity
Next.js route groups let us isolate marketing, app, and portal layouts completely. Each has its own auth model, sidebar, and design language — without fighting a single monolithic layout.
Drizzle ORM + Neon = serverless bliss
Type-safe database access with schema push (no migration files in dev) and serverless connection pooling eliminated entire categories of deployment headaches. 48 tables, zero migration drift.
About KumoKodo.ai
We specialize in building AI-powered SaaS applications using modern cloud-native technologies. Our team combines expertise in machine learning, full-stack development, and user experience design to create products that solve real business problems.
Want to Try Kodokyo?
Start your 14-day free trial and experience the AI-native project OS. Or contact us to discuss building a similar platform for your business.