codespeak init
⚠️ CodeSpeak is in Alpha Preview: many things are rough around the edges. Please use at your own risk and report any issues to our Discord. Thank you!
Initialize a new CodeSpeak project in the current directory.
Synopsis
codespeak initDescription
Creates the necessary configuration files and project structure for a new CodeSpeak project. If inside a Git repository, the project is created at the Git repo root (not necessarily the current directory).
By default, this creates:
project/
├── .codespeak/ # Internal state used by CodeSpeak
├── .gitignore
├── codespeak.json # Project configuration
└── spec/
└── main.cs.md # Your spec — edit this to describe what you want to build
If run inside an existing codebase, it creates codespeak.json at the repo root without generating a spec directory. You then manually register specs and configure which files CodeSpeak can modify.
Error messages
| Error | Cause | Resolution |
|---|---|---|
| CodeSpeak project at {path} already initialized | Running init in a directory that already has codespeak.json | The project is already set up — edit codespeak.json directly |
See also
codespeak.json— project configurationAGENTS.md— project context for agents- Spec file naming — naming conventions
- Model selection — choose a model
- Quick Start — build a project from scratch
- Mixed Mode tutorial — add CodeSpeak to an existing codebase
- Django Oscar tutorial — mixed mode with a Django project