codespeak impl
⚠️ 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!
Implement your project according to the specification file(s), skipping test generation and execution.
Synopsis
codespeak impl [spec_path] [--skip-tests] [--no-interactive] [--no-diff-check]Description
Like codespeak build, but skips the dedicated test generation and execution phases. The implementation phase itself can still run tests to verify its work, but there is no separate test improvement loop.
Use this for faster iteration when you want to see the implementation quickly and will test manually.
Skipping builds when a spec has no changes
If all specs you are building do not have any changes since the last successful build, the impl command will exit with the message: "No spec diff found".
Flags
| Flag | Description |
|---|---|
spec_path | Path to the specification file. If omitted, all registered specs are built |
--skip-tests | Skip improving test coverage (already implied by impl) |
--no-interactive | Run in non-interactive mode without real-time progress updates |
--no-diff-check | Skip the check for uncommitted changes before building |
Error messages
| Error | Cause | Resolution |
|---|---|---|
| Can't find spec to build | No .cs.md files found and no specs registered in codespeak.json | Create a spec file or register one in codespeak.json |
| Spec file not found: {path} | A spec path was specified (as a command argument, default entry point, or import) but the file doesn't exist on disk | Check the path for typos, or create the spec file |
| Spec file is empty: {path} | The spec file exists but has no content | Add content to the spec |
| Build cannot be started with an existing change request | A change request file exists alongside spec changes | Either remove the change request file and build, or finish the change request with codespeak change |
| Cannot specify both a positional spec path and --spec | Both positional path and --spec flag provided | Use one or the other |
| Anthropic API Key not found | No API key configured | Set the ANTHROPIC_API_KEY environment variable or run through the interactive setup |
| Circular spec dependency detected: A -> B -> A | Spec imports form a cycle | Remove the circular import |
| {path} does not belong to a CodeSpeak project | No codespeak.json found | Run codespeak init first |
See also
codespeak build— full build with testscodespeak run— build and run the application