ai-workspace-generator

Generate and adapt an AI workspace for any project — new or existing — so that Claude Code, GitHub Copilot (VS Code and Visual Studio) and OpenAI Codex follow the same rules, conventions and workflow. Run one command, answer a few questions, and your project gets what it needs: instructions, skills, a safe development flow (SDD), living documentation and more.

No commands to memorize. After setup you talk to the AI in plain language ("add this feature", "update this library", "save the changes") and it applies the right flow.

Shared-first, aimed at individual developers (learning, interview prep, training, programming with utilities). It can also target a company as an optional extension point (company). No real business data.

Install

Requirements: Node.js ≥ 20, and at least one of: VS Code + Copilot · Claude Code · Visual Studio + Copilot · Codex.

Easy (recommended) — install the prebuilt tarball from the latest GitHub Release (no clone, no build):

npm i -g https://github.com/grojof/ai-workspace-generator/releases/latest/download/ai-workspace-generator.tgz
ai-workspace --version

Expert / from source:

git clone https://github.com/grojof/ai-workspace-generator.git
cd ai-workspace-generator
npm install && npm run build && npm link

Update: re-run the easy install for the newest release, or git pull && npm run build from source.

The package is ai-workspace-generator; the installed command is ai-workspace.

No Node yet? Tell your AI assistant "install ai-workspace from <repo URL>" and let it guide the setup. A truly Node-less standalone binary is planned separately.

Use in 3 steps

cd /path/to/your-repo
ai-workspace init     # 1) wizard: auto-detects your stack and writes workspace.config.yaml
                      # 2) open the repo in your editor/agent (VS Code, Visual Studio, Claude Code, Codex)
ai-workspace sync     # 3) after editing AGENTS.md or the config, regenerate (idempotent)

After init, read AI-WORKSPACE.md: the index of everything generated. Existing project? Let the AI configure it: run the /configure skill and it proposes your workspace.config.yaml by analyzing the repo.

⚙️ Targets and options — which tools, .vscode, multi-repo

`targets`	Generates	Notes
`claude`	`CLAUDE.md` + `.claude/` skills + `.mcp.json`	Claude Code
`copilot`	`.github/copilot-instructions.md` + `instructions/*`	VS Code and Visual Studio (enable the toggle in Tools → Options → GitHub → Copilot)
`codex`	`AGENTS.md` (native instructions) + `.codex/config.toml`	OpenAI Codex (CLI/IDE), cross-platform
`opencode`	`AGENTS.md` + `.claude/skills/` (read natively) + `.opencode/opencode.json` (MCP)	OpenCode (open-source TUI), cross-platform

AGENTS.md is always generated (single source of truth and the native adapter for Codex & OpenCode).
vscode: false skips the .vscode/ folder (for Visual Studio or non-VS-Code users).
Multi-repo: an optional repos: list governs several linked repos (each with its path/stack); the root is the coordinator and each child gets its own adapter. distribution.perRepo splits distribution per repo.

Full reference: Usage guide.

📦 Commands

Command	What it does
`init`	Wizard → writes the config → generates the workspace (`--simple` / `--advanced` / `--yes`)
`sync`	Regenerate from the config (preserves your edits outside the markers)
`detect`	Detect the stack (read-only); `--json` as a seed for the AI
`add` / `remove`	Add or remove a language, framework, environment or MCP
`list`	Current config + module catalog (enabled vs available)
`import`	Ingest existing material and prepare its reconciliation
`upgrade`	Diff templates and apply the update (`--check` to preview)
`doctor`	Lint the workspace (token budget, key artifacts, stack ids)
`package`	Package as a plugin + private marketplace + per-skill zips
`skills sync`	Update the vendored skill-packs from upstream

Detail: Usage guide.

🚀 Distribute and install as a plugin — for your team / organization

ai-workspace package projects the workspace into a Claude Code plugin served from the repo itself as a private marketplace, and stages per-skill zips to upload to a claude.ai organization. Three install surfaces (VS Code/CLI, Desktop/Cowork, claude.ai Team/Enterprise):

/plugin marketplace add <owner/repo or git URL>
/plugin install <plugin>@<marketplace>

ai-workspace-generator

Popularity

What's Inside

README