Skip to content

Home

Jump to bottom
Vytautas Čepas edited this page May 18, 2026 · 4 revisions

project-init

Scaffolder that drops a .claude/ folder into any project so Claude Code (and other agents) have memory, hooks, skills, and MCPs ready from day one.

What it does

One command → structured .claude/ layout inside your project:

<your-project>/
├── CLAUDE.md                # canonical agent instructions
├── AGENTS.md                # redirect for non-Claude agents
└── .claude/
    ├── config.yaml          # options chosen at init
    ├── settings.json        # hooks wired to Claude Code events
    ├── skills/ hooks/ scripts/ agents/ rules/
    ├── memory/MEMORY.md     # grep-able memory index
    └── vault/               # Obsidian vault (humans)

Re-running is safe — it reconciles and never overwrites memory or vault notes.

Presets

Preset What you get
obsidian-only Base scaffold + Obsidian vault for humans
obsidian-lightrag Above + LightRAG knowledge graph index for agents

Install

curl -sSL https://raw.githubusercontent.com/VytCepas/project-init/main/install.sh | bash

Installs uv if missing, clones the repo to ~/.local/share/project-init, and registers a /project-init slash command in Claude Code.

Usage

Interactive — inside a Claude Code session:

/project-init

Non-interactive — CI or scripts:

uvx --from ~/.local/share/project-init project-init . \
  --non-interactive \
  --preset obsidian-only \
  --name my-app \
  --language python \
  --mcps context7

The wizard asks: project name/description, language (Python / Node / Go / none), memory stack, and MCP selection (Context7, database, Playwright). Answers are saved to .claude/config.yaml.

Principles

  • One folder — .claude/ for everything agentic; project root stays clean
  • Deterministic-first — hooks/scripts are bash/python; LLM calls only where generative
  • Model-agnostic — AGENTS.md redirects non-Claude agents to the canonical CLAUDE.md
  • bun and uv only — no npm/npx/pip/venv in scaffolded projects

Repo Layout

project-init/
├── src/project_init/    # wizard CLI + scaffold engine
├── templates/
│   ├── base/            # always copied into target projects
│   ├── obsidian/        # Obsidian overlay
│   ├── lightrag/        # LightRAG overlay
│   └── presets/         # toml preset definitions
└── tests/               # pytest modules by behavior area

Further Reading

Clone this wiki locally