Multi-Project Support

Kangentic supports multiple projects in a single window. Each project has its own board, columns, sessions, and settings — switch between them from the sidebar.

The sidebar displays all your projects. Click a project to switch to its board. Each project is independent:

Its own set of columns (which you can customize per-project)
Its own tasks and agent sessions
Its own settings overrides
Its own database stored in .kangentic/ within the project directory

Drag projects to reorder them — the order persists across app restarts.

Project Actions

The selected project shows action buttons directly on its row:

Button	Action
Open in Explorer	Opens the project directory in your file manager
Project Settings	Opens per-project settings
Delete	Removes the project from Kangentic (with confirmation)

Right-click any project to open a context menu with additional options:

Option	Action
Rename	Edit the project name inline — press Enter to save, Escape to cancel
Open in Explorer	Opens the project directory
Project Settings	Opens per-project settings
Move to [Group]	Move the project into a project group
Remove from group	Move the project out of its current group (only shown for grouped projects)
Delete	Remove the project from Kangentic

Adding Projects

From the app

Click New Project in the sidebar:

Enter a project name
Select the project directory (the root of your git repository)
Optionally add a GitHub URL
Click Create

Kangentic initializes a .kangentic/ directory inside your project (auto-added to .gitignore) and creates a board with default columns.

From the command line

Open a project directly from your terminal:

npx kangentic open            # Open the current directory
npx kangentic open /path/to   # Open a specific project path

If the project doesn’t exist in Kangentic yet, it’s created automatically.

Per-Project Settings

Project-level settings override global defaults for that repository. You can customize:

Default permission mode
Git worktree settings (base branch, copy files, init script)
Terminal font and size
Auto-focus and notification behavior

Project settings are stored in .kangentic/config.json. See Settings for the full list of configurable options.

Startup Behavior

Every project is opened when Kangentic launches, so agents from all projects are ready to resume immediately. If you’d rather not auto-resume suspended sessions on launch (e.g., to avoid a startup stampede when many tasks have auto_spawn enabled), turn Auto-Resume Agents on Restart off in Settings, under the Behavior tab. The projects still open; the sessions stay paused until you click Resume on each task.

The sidebar header and each project row surface task counts so you can gauge load at a glance without switching projects:

Header counts: totals across all projects
Per-project counts: active (thinking) and idle task counts for that project
Group counts: for collapsed project groups, the aggregated counts for projects inside the group

These counts update live as agents move between states.

Cross-Project Awareness

The sidebar shows real-time agent status for every project:

Thinking badge (green spinner) — shows the count of actively running agents
Idle badge (amber) — shows the count of agents that need attention (idle, waiting for input, or permission-blocked)

When agents need attention on a project you’re not currently viewing:

The taskbar icon flashes (Windows) to get your attention
Desktop notifications fire with the task name as the title and project name in the body
Clicking a desktop notification brings the window to the foreground, switches to that project, and opens the task detail dialog
Auto-focus can switch to the idle session’s tab automatically

These notifications help you manage agents across projects without constantly switching between boards. See Notifications for more details.