Skip to main content
Each project in Claude Board represents a codebase that Claude agents work on. Configure projects to match your repository structure and workflow preferences.

Core Settings

SettingDescription
NameDisplay name shown on the board
SlugURL-safe identifier, auto-generated from name
Working DirectoryAbsolute path to the project’s codebase
AvatarOptional project icon or image
The working directory must exist and be accessible by the process running Claude Board. Claude agents read and write files in this directory.

Permission Mode

Controls how Claude handles tool permissions. See Permissions for details.
ModeBehavior
Auto AcceptClaude uses all tools without confirmation
Allowed ToolsOnly specified tool categories are permitted
DefaultUses Claude CLI’s built-in permission behavior

Allowed Tools

When using Allowed Tools mode, specify which tool categories Claude may use:
  • Read — read file contents
  • Edit — modify files
  • Write — create new files
  • Bash — run shell commands
  • Glob — search file patterns
  • Grep — search file contents

Additional Settings

Enable automatic task execution and set max concurrent agents (1–5). See Auto-Queue.
Configure auto-branch creation, auto-PR, and base branch. See Git Automation.
Add notification endpoints for task events. See Webhooks.
Define project rules injected into every prompt. See Snippets.
Create reusable prompt patterns. See Templates.

Editing a Project

Click the gear icon on the project dashboard to open settings. Changes are saved immediately. Changing the working directory does not affect running tasks — only new agent sessions use the updated path.