codespeak-vibe-share

One of the things we are working on at CodeSpeak is converting vibe coding sessions into maintainable specs. To make this tool better, we are asking people to donate their vibe coded projects (code, git history, and agent sessions).

This tool will not upload any of your project data without your explicit permission.

To retract or request deletion: [email protected]

🫶 Thank you for helping us make programming better. 🫶

Development

Components

| Component | Description | |---|---| | root (src/) | CLI tool and shared library (codespeak-vibe-share) | | session-viewer/ | Next.js app for browsing uploaded sessions | | backend/ | AWS CDK infrastructure |

Setup & build

make install   # install deps for all components
make build     # build all components

Or per component:

make install-root     && make build-root
make install-viewer   && make build-viewer
make install-backend  && make build-backend

Running locally

make dev-cli      # run the CLI in dev mode (tsx, no compile step)
make dev-viewer   # build root lib then start session-viewer on localhost:3000

dev-viewer builds the root package first — required because session-viewer depends on codespeak-vibe-share via file:.. and needs dist/ to exist.

Tests & lint

make test         # run all tests
make test-viewer  # session-viewer tests only

make lint         # lint all components
make lint-viewer  # session-viewer only

Deploy

make deploy-backend   # cdk deploy

Usage

npx codespeak-vibe-share

The tool will:

1. Discover agent session on your machine
2. Give you a list of project these agents contributed too
3. Let you choose which project to share
4. Give you a preview of what's going to be shared
5. Ask your consent
6. If you agree, upload the project to be shared with CodeSpeak