Coday is a conversation-based agentic framework that helps developers work with AI agents on existing projects. It provides natural language interaction with AI through a web interface, supporting multiple AI providers (OpenAI, Anthropic, etc.) and extensive customization.
✨ Web Interface - Modern browser-based interface with rich formatting
🤖 Custom Agents - Define specialized agents for your project's needs
🔌 Provider Agnostic - OpenAI, Anthropic, or any compatible AI provider
🛠️ Extensible Tools - Built-in tools plus MCP (Model Context Protocol) integrations
💾 Memory System - Persistent context and knowledge across conversations
📁 Project-Scoped - Configuration and context tied to your codebase
🎯 Webhook Support - Programmatic API for external integrations
- Node.js 22+
- npm (comes with Node.js)
- (have
ANTHROPIC_API_KEYand/orOPENAI_API_KEYas env vars)
That's it!
npx --yes @whoz-oss/coday-webThis command will:
- Download the latest version (if needed)
- Start the web server
- Open your browser at
http://localhost:3000 - Run from the directory you were at
📖 For detailed setup instructions, see Installation Guide.
- Launch Coday - Run
npx --yes @whoz-oss/coday-web - Create/Select Project - Point Coday to your project directory
- Configure AI Provider - Add your OpenAI or Anthropic API key
- Start Conversation - Type your first message to an agent
📖 Complete walkthrough: Your First Conversation
- Introduction - What is Coday and how to think about it
- Installation
- Launching Coday
- First Conversation
- Prompting Strategies
- Context and Memory
- Detecting Hallucinations
- Iterative Workflows
- Agent Design
- Agent Tooling
- Troubleshooting
- Development Workflow (contributors)
Create a coday.yaml in your project root:
description: |
Brief description of your project for AI context.
ai:
- name: anthropic
apiKey: sk-**ABCD
- name: openai
apiKey: sk-**EFGH
agents:
- name: backend-expert
description: backend specialist
instructions: |
You specialize in backend development.
Focus on API design, database optimization, and performance.📖 See Project Configuration for complete guide.
We welcome contributions! Please see:
- Development Workflow - Contribution guidelines
Releases are automated via GitHub Actions based on conventional commits. See Automated Release Process for details.
- ✅ OpenAI (GPT-4, GPT-4o, etc.)
- ✅ Anthropic (Claude 3.5 Sonnet, etc.)
- ✅ Any OpenAI-compatible API
MIT License - see LICENSE file for details.