Projects Overview

Create and manage Zenflow projects to organize your AI-driven development work.

What is a Project?

A project in Zenflow represents a scope of work tied to one or more repositories. Projects contain tasks, workflows, and automation settings that define how AI agents interact with your codebase.

Project hierarchy

Organization → Projects → Tasks → Subtasks/Chats

Each level inherits settings from above while allowing overrides for specific needs.

Creating a Project

1. Open Zenflow

   Launch the Zenflow desktop app and sign in with your Zencoder account.

2. Click New Project

   From the home screen or sidebar, click New Project to start the setup wizard.

3. Connect your repository

   Choose a local repository or clone from GitHub/GitLab. Zenflow will analyze the codebase structure.

4. Configure automation

   Set up your default agent, verification scripts, and workflow preferences. You can always adjust these later.

5. Start working

   Your project is ready! Create your first task to begin.

Project Dashboard

The project dashboard gives you a complete view of ongoing work:

Kanban Board

Visual task management with customizable columns:

• Backlog: Tasks waiting to be started
• In Progress: Active tasks with running agents
• Review: Tasks pending human review
• Done: Completed and merged work

Task List

Sortable, filterable list of all tasks with status, assignee, and progress indicators.

Inbox

Notifications and action items requiring your attention—review requests, verification failures, and agent questions.

Multi-Repository Projects

Zenflow supports projects spanning multiple repositories:

• Monorepo mode: Single project covering all packages/services
• Multi-repo mode: Linked repositories with cross-project visibility
• Submodule support: Automatic handling of Git submodules

For microservice architectures, consider creating one project per service for better isolation, then use tags or labels to group related work.

Project Settings

Access project settings via the gear icon or Project → Settings:

Setting	Description
Default Agent	Which AI agent runs tasks by default
Default Workflow	Preferred workflow for new tasks
Verification Script	Commands to run after each agent turn
Setup Script	Commands to run when creating worktrees
Copy Files	Local files to copy into each worktree

Next Steps

Project Configuration

Deep dive into .zenflow/settings.json

Tasks Overview

Learn how to create and manage tasks