Start here / how to report

[alondero]

Welcome to Buildmesh

Run AI coding agents side by side in persistent terminals, with Git worktrees keeping their changes apart.

Buildmesh is Windows early access: you bring the agent CLIs; updates are minisign-signed; installers are not OS-code-signed, so SmartScreen warnings are expected.

Your first session

1. Download a Windows installer from Releases.
2. Install and sign in to the coding CLI you want to use, on Windows or inside WSL for a WSL mesh. You supply the CLI and its account or API key. The Terminal harness works without a coding CLI.
3. Follow the first-session guide to add a repository and spawn a session.

See Troubleshooting for installation, CLI detection and session problems.

Where to ask or report

• Questions / setup help: use Q&A. Include your Buildmesh version, Windows version, CLI name/version and whether the session runs natively or in WSL.
• Ideas / workflow feedback: use Ideas. Describe what you are trying to do and what currently gets in your way.
• Reproducible bugs: search existing issues, then open a bug report. Include the steps, expected and actual behavior, versions and a small screenshot or log excerpt if useful. If you are unsure whether it is a bug, start in Q&A.
• Security vulnerabilities: report privately through GitHub Security Advisories, following SECURITY.md.

Remove API keys, tokens, private repository names and personal paths from screenshots and logs before sharing them. Never paste credentials into an issue or discussion.

The README and user guide are the documentation home. Discussions is the community home.