context-kit · welcome

Set up your project so an AI assistant can build with direction.

1.Welcome

context-kit helps your AI coding assistant remember what you're building across sessions. Without it, the AI starts cold every time, drifts, and hallucinates confidently. With it, the project stays coherent.

This wizard walks you through setting up your first project. You'll type your idea once; we'll generate the right files and tell you exactly which terminal commands to run.

If you'd rather use the CLI directly, every step shows the command. Skip the wizard whenever you want.

2.Where should we create your project?

Give your idea a short, clear name. This becomes the folder where your project files will live.

cwd: …

Examples: "Dad Med Reminder", "Kids Fitness Tracker", "Landscaping Dashboard"

Auto-created from the project name. You usually don't need to change this.

3.What are you building?

Just describe your idea like you would to a friend. Don't worry about getting it perfect — we'll turn this into a plan.

You can leave most of this blank. Just start with your idea.

Example: "an app to remind my dad to take his medication"

Example: "just me", "my kids", "my parents", "small business owners"

What's frustrating, missing, or hard today?

Keep it small. Example: "track steps and show points"

We can suggest a stack for you.

Questions, ideas, worries, or things you want the AI to consider.

Want help thinking this through?

Copy this prompt into ChatGPT, Claude, or another AI assistant if you want help turning your idea into a simple plan.

4.Save your idea.md

Here's what we'll write. You can go back and edit any field.

(loading)

Target: …

5.Initialize the project

Keep this page open.

In a new terminal window, run:

context-kit init "…"

If you're using VS Code:
Click "Terminal" → "New Terminal"

If that says command not found, try:

python3 -m context_kit init "…"

This can happen when a new terminal does not have the same Python environment active.

After it finishes, click below. We'll verify the project files exist.

6.(optional) See the recommended stack

If you skipped Tech stack above (or want a second opinion), run:

context-kit recommend-stack …

Read the recommendation in your terminal. Then click below. (You can also skip this — seed auto-fills the stack section if you didn't write one.)

7.Seed the project

Bake your idea into the project's load-bearing files:

context-kit seed …

After it finishes, click below. We'll verify docs/BUILD_PLAN.md exists.

8.Check your environment + you're ready

Last thing before you build: verify your environment is set up (Python, git, Node, Expo, file watchers, etc.):

context-kit doctor

Warnings here are fine on a first run. Only the red X blocking lines need attention.

You're set up.

Open this folder in your AI coding tool. If you use Claude Code, run:

claude

The bundled skill loads automatically. If you use a different AI tool, point it at this folder — it just won't auto-load the skill.

Then paste this as your first prompt so the AI reads the load-bearing docs before writing any code:

Read CLAUDE.md, docs/BUILD_PLAN.md, and docs/*_WHAT_IT_IS.md. Summarize the project, confirm the stack, then begin implementing version 1. Do not change the stack without asking.

BUILD_PLAN.md is the source of truth for your tech stack. Without this prompt, the AI may pick a different stack than the one you chose, and you'll get code that doesn't fit your plan.

Whenever you come back, run context-kit start again to resume or to view your project.