Projects
A Project is the central unit of work in Kodel.AI. It connects your git repository, team members, AI configuration, and task board into one place.
Project components
Section titled “Project components”Board & Tasks
Section titled “Board & Tasks”Every project has a Kanban/Scrum board with tasks. Each task can be assigned to the AI agent, which will:
- Checkout a new branch
- Implement the task
- Run tests
- Open a pull request
Workflows
Section titled “Workflows”Workflows define the statuses tasks move through (e.g., Backlog → In Progress → Review → Done). You can bind AI jobs to specific transitions — for example, automatically running a code review when a task moves to Review.
Modules
Section titled “Modules”Modules are git repositories linked to a project. The agent clones these into /workspace and can read, write, and commit code. A project can have multiple modules (e.g., backend, frontend, infra).
Instance Templates
Section titled “Instance Templates”Instance Templates define the Docker environment the agent runs in:
- Base image (Ubuntu, Alpine, etc.)
- Pre-installed packages
- Setup scripts
- Environment variables
- Docker-in-Docker support
Roles & permissions
Section titled “Roles & permissions”| Role | Can do |
|---|---|
| Admin | Full project access, manage members |
| Tech Lead | Manage workflows, templates, and agent config |
| Developer | Create tasks, run agent jobs, review artifacts |
| Reviewer | View tasks and artifacts, approve/reject |
| Viewer | Read-only access |
Creating a project
Section titled “Creating a project”- Go to Projects → New Project
- Choose a workflow template (Software Dev, Kanban, or custom)
- Add team members and assign roles
- Link a git repository as a Module
- Configure an Instance Template for the agent