Skip to main content

Project Integration

Pro

Bring your Cohort agents to every project. One manifest file links any directory to your full agent team.

Portable agents. Scoped permissions. Automatic scaffolding. No copy-paste.

The Problem

Copy-paste agents
Every new project means manually recreating agent configs, prompts, and memory. Your agents start from zero each time.
No permission boundaries
Agents have full access to everything or nothing. No way to scope what they can see or modify per project.
Setup fatigue
README templates, CI configs, directory structures, linting rules -- the same boilerplate every time before real work starts.

The .cohort Manifest

One file in your project root connects it to your Cohort installation. Your agents, their memory, and your permissions travel with you.

# .cohort (auto-generated)
version: "1.0"
cohort_root: "~/cohort"
project_name: "my-saas-app"
working_memory_path: ".cohort-memory/"
permissions:
profile: "standard"
allow_paths:
- "src/"
- "tests/"
- "docs/"
deny_paths:
- ".env"
- "credentials/"
allowed_tools: [read, write, search, test]
max_turns: 25

How It Works

Link project --> .cohort created --> Agents available --> Scoped memory

1. Link or CreatePro

Point Cohort at any directory. The manifest resolves back to your Cohort installation so agents, skills, and personas are always available. No copying, no symlinking.

# Link an existing project
$ cohort link /path/to/my-project

2. Scoped PermissionsPro

Each project defines what agents can access. Allow-list specific directories, deny sensitive paths like .env and credentials/. Set tool restrictions and max turn limits. Your agents can only touch what you allow.

3. Project-Scoped MemoryPro

Each linked project gets its own .cohort-memory/ directory. Agents build context about this project -- architecture decisions, coding patterns, past reviews -- without polluting their global knowledge. Auto-gitignored.

4. ScaffoldingPro

New projects get automated housekeeping: directory structure, CI config templates, linting rules, README scaffolding, and git initialization. Skip the boilerplate, start building.

What Travels With You

Your Cohort installation is the source of truth. Every linked project points back to it.

Shared (from Cohort root)

Agent configs & personas
Skills & slash commands
MCP server & tools
LLM router & models
Global agent memory

Scoped (per project)

Working memory
File permissions
Tool restrictions
Turn limits
Project-specific context

Use Cases

Multi-repo development

Working across 5 repos? Link them all. Your security agent knows your auth patterns, your python dev remembers your coding style, your QA agent knows your test conventions -- regardless of which repo you're in.

Client projects with boundaries

Each client project gets strict permission scoping. Agents can't accidentally reference one client's code when working on another. Memory stays isolated per project.

Rapid prototyping

Spin up a new project directory, link it, and immediately have your full team available. No setup, no config, no boilerplate. Start building in seconds.

Your Agents, Every Project

Project Integration ships with Cohort Pro. Link unlimited projects to one Cohort installation.