Contextuate

What is Contextuate?

Contextuate provides a structured "brain" for your project that AI coding assistants (like Claude, Copilot, Cursor) can understand. It standardizes how AI agents receive context, follow coding standards, and execute tasks.

Discovery

The AI reads docs/ai/context.md first. This file maps the project and links to all other resources.

Specialization

If acting as a specific agent, it reads docs/ai/agents/ to load specific capabilities and rules.

Execution

The AI follows the linked standards in docs/ai/standards/ and uses docs/ai/quickrefs/ for technical lookups.

Quick Start

Installation

Clone the repository and install globally:

git clone https://github.com/esotech/contextuate.git
cd contextuate
npm install
npm run build
npm link

Initialize Your Project

Navigate to your project directory and run:

contextuate init

The interactive installer will guide you through selecting AI platforms, creating directory structures, and generating configuration files.

CLI Usage

Running Agents

Execute an agent definition with the run command:

contextuate run <agent-name> [options]

Example:

contextuate run documentation-expert --task api-refactor --goal "Update API docs" --isolation worktree

Context Management

Generate a token-optimized map of your codebase:

contextuate index