codespeak run
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 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