codespeak run
⚠️ 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!
Build and run the target application.
Synopsis
codespeak run [spec_path] [--skip-tests] [--no-interactive] [--no-diff-check]Description
Runs codespeak build and then starts the target application. If the build fails, the app is not started. Useful for quick iteration — build and see the result in one step.
Flags
| Flag | Description |
|---|---|
spec_path | Path to the specification file. If omitted, all registered specs are built |
--skip-tests | Skip improving test coverage |
--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 |
| 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 |
| Failed to start target app: {reason} | The application failed to start after a successful build | Check the error details and fix the spec or environment |
See also
codespeak build— build without running- Quick Start — build workflow walkthrough