Overview
Understand how Stoa turns live collaboration into decisions, provenance, and shared context.
Stoa is a collaborative workspace and CLI that capture decisions as they happen and connect them directly to the code they produce. Instead of writing follow-up docs or chasing context later, your team works inside sessions where voice, code, and decisions live together.
You can trace any change back to the conversation that produced it, review and curate decisions in real time. Six months from now, you can click on any line and see exactly why it was written.
How it works
Stoa has three layers that work together:
Session capture
Records AI coding sessions and file changes so decisions and provenance are captured automatically.
Workspace
A shared space for voice, code, and decisions where the team can build and review work together.
Local repo
Everything is stored locally in a .intent/ folder inside your project unless you enable sync.
Core workflow
- Create a Space or open a project to route into a session workspace.
- Join the call so voice/video connects and meeting panels become active.
- Talk and build while decisions and context are captured in real time as you work.
- Review and share by curating decisions, adding notes, and inviting guests as needed.
- Follow up locally using the CLI to inspect provenance and keep working in your editor.
Sessions and meeting artifacts
Work in Stoa happens inside sessions. Opening a Space routes you into the current session (or creates a new one), and joining the call connects voice and video. Each session includes:
- People, Transcript, Chat that are active when you're in a call
- Notes and Recordings that stay tied to the session even after you disconnect
- Decision Topics detected in real time from your conversation, with coverage checking against your meeting context files
- Decisions extracted with review states (accept/reject), editable fields, and archives
Guest invites are created from the session menu and are scoped to a session. The People panel invite UI is currently desktop-only.
Who uses Stoa?
- Product managers who run kickoffs, design reviews, and planning sessions and want decisions captured automatically.
- Engineers who need to trace why code exists and follow changes back to the conversation that produced them.
- Teams who want voice, code, and decisions in one place without maintaining a separate knowledge base.
What you can do with it
- Track decisions without extra work. Stoa captures decisions from your AI coding sessions and team meetings automatically. You don't need to take notes or update a wiki.
- See where your code came from. Every line of code is linked to the conversation that produced it, so you can trace a change back to the prompt or meeting that created it.
- Collaborate in real time. Edit code together with your team. Multiple people can work on the same file at once with no merge conflicts.
- Let the AI build during meetings. The Space Agent can write code, run it, and show live previews while your team discusses what to build.
- Review and curate decisions. Decisions can be accepted or rejected, edited inline, and enriched with objectives and comments as you refine what was decided.
- Extend with plugins. Space Plugins let you add custom widgets, file renderers, and transcript processors using JavaScript files that live in your project and sync to all participants.
- Use voice to agent. Push-to-talk voice prompts are available when you're in a call, transcription is connected, and the agent is running.
- Share sessions with guests. Create session-scoped invite links so collaborators can join without full team access.
- Work in isolated branches. Episodes let you experiment in an isolated workspace (like a Git branch, but for decisions). Try something out, and merge it back if it works.
- Use the macOS desktop app. A native app with menu bar integration, system notifications, and drag-and-drop file support. Same features as the web, with a native feel.
Data and sync
Everything is stored locally in your project's .intent/ directory by default. Cloud sync is optional and only happens when you enable it.