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.

Sidebar Project List

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
Change Directory…	Re-point the project at a moved or renamed folder (see Relocating a Project)
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:

1. Enter a project name
2. Select the project directory (the root of your git repository)
3. Optionally add a GitHub URL
4. 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.

Relocating a Project

If you move or rename a project folder on disk, you can re-point Kangentic at the new location instead of re-adding the project:

• Right-click the project in the sidebar and choose Change Directory…, or
• Open Project Settings > General and click the Change… button next to the project location.

Tasks, sessions, and board history are keyed by project ID, so everything is preserved. Kangentic validates the new path, suspends any live sessions so they resume at the new location, rewrites stored worktree and session paths, and repairs the moved repository’s git worktree metadata.

If Kangentic launches and a registered project’s folder is missing, a Project Folder Not Found dialog appears with a Locate Folder… button so you can point it at the new location. The project is never silently recreated at the stale path.

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.

When you create a new project, Kangentic seeds it with only a subset of your most recently configured project’s settings - theme, terminal preferences, default permission mode, and git options. Project-specific data such as the embedded browser’s default URL and saved backlog import sources stays per-project and is never copied into a new project.

Note

Some settings like max concurrent sessions and sidebar width are global-only and cannot be overridden per-project. These apply across all projects.

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.

Sidebar Counts

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.

Next steps

Next: Project Groups - organize the sidebar when project counts grow.

See also:

• Notifications & Monitoring - desktop alerts that span projects
• Settings - per-project defaults and overrides