A agenv portable AI workspace setup

Open source AI workspace infrastructure

Define your AI workspace once.

agenv gives teams one calm, reviewable place to manage Codex, Copilot, Claude, MCP, Cursor, and Windsurf setup.

Scan the repo, create ai-workspace.json, and generate the instruction files and tool config your project actually needs, without hand-maintaining the same intent in four different places.

Star on GitHub
Works for 7 project types including library, cli-tool, and mobile Open source, MIT licensed, CLI-first Protects manual edits unless you force
The manifest layer for AI-native teams

setup in under a minute

$ npm install -g agenv-cli
$ agenv init --yes
$ agenv generate

canonical source of truth

{
  "project": { "type": "web-app" },
  "targets": {
    "codex": true,
    "copilot": true,
    "claude": true,
    "mcp": false,
    "cursor": false,
    "windsurf": false
  }
}

generated outputs

Codex Codex AGENTS.md Copilot Copilot copilot-instructions.md Claude Claude .claude & .mcp.json Cursor Cursor .cursor/rules Windsurf Windsurf .windsurf/rules MCP MCP .mcp.json

What you get

A simpler shape for AI setup.

The goal is not more automation noise. It is less repeated setup, clearer ownership, and safer updates across tools.

01

One manifest

ai-workspace.json becomes the source of truth for how the repo wants AI tooling to behave.

02

Generated outputs

Create AGENTS.md, Copilot instructions, Claude files, and MCP config from one plan.

03

Safer maintenance

Use diffs, generated headers, and explicit overwrite behavior so updates stay reviewable.

Codex GitHub Copilot Claude Code MCP Servers Cursor Windsurf Portable manifests Repo-safe generation Codex GitHub Copilot Claude Code MCP Servers Cursor Windsurf Portable manifests Repo-safe generation

Why it is useful

Most repos do not need more AI files. They need fewer decisions to repeat.

agenv is for the moment a team realizes its prompts, instructions, and tool config are drifting apart faster than anyone wants to maintain them.

Scan the repo before making choices

agenv inspects the repo, detects the stack, and starts from the codebase you already have.

Keep tooling aligned

Codex, Copilot, Claude, and MCP outputs come from one system instead of separate rituals.

Review setup like product code

agenv diff and generated headers make changes easier to reason about in pull requests.

How it works

Small command surface. Predictable workflow.

The workflow stays intentionally small so it remains readable after the first setup, not just during the first demo.

  1. Inspect the repository. Detect frameworks, package managers, and existing AI files.
  2. Create ai-workspace.json. Capture targets, generation depth, prompts, and tool preferences.
  3. Generate the outputs you want. Write instructions, prompt packs, and tool-specific config from one plan.

Command surface

  • agenv init creates the manifest from repo inspection plus prompts.
  • agenv generate writes the planned files for enabled targets.
  • agenv diff previews changes before the repo is touched.
  • agenv doctor validates compatibility and manifest health.
  • agenv templates list shows starter templates.

Generated outputs

The files map cleanly to the tools your team already uses.

Instead of describing every feature abstractly, agenv turns the manifest into concrete files people can open, diff, and ship.

AGENTS.md for Codex

Project-specific guidance that stays in sync with the manifest instead of drifting over time.

Copilot instructions

Repo-level guidance generated from the same workspace decisions used everywhere else.

Claude workspace files

Shared Claude setup can be generated without treating it like an unrelated sidecar system.

MCP configuration

Reviewable server presets — including Notion, Stripe, GitHub, and more — with trust-level annotations baked in.

Cursor & Windsurf rules

Rule files for Cursor (.mdc) and Windsurf (.md) generated from the same manifest as every other target.

Built for open source

Infrastructure your repo can keep living with.

The value is not novelty. It is lowering the maintenance cost of AI setup as tools change around the repository.

Manifest first

The workspace is described in a plain file your team can diff, discuss, and commit.

Safe by default

Manual edits stay protected unless you explicitly ask agenv to overwrite them.

Multi-tool on purpose

Generate Codex, Copilot, Claude, MCP, Cursor, and Windsurf config without duplicating intent across tools.

Made for web repos

Supports 7 project types — dashboard, web-app, api-service, full-stack, library, cli-tool, and mobile — with stack-aware defaults.

Launch

Ship the story and the repo together.

This page is built for GitHub Pages with Jekyll, so the marketing surface and the open-source code can live in the same repository without fighting each other.

Open repository View on npm