How to use MainStreet

Close the loop between AI and your team

MainStreet connects the markdown your AI tools generate to the people who need to read, comment on, and edit it — without copy-pasting into Google Docs or teaching anyone git.

The Problem

The copy-paste loop is broken

When you use Claude Code or similar AI tools, you produce a lot of markdown — research docs, specs, architectural decisions, knowledge bases. That output lives in your git repo. But the people who need to collaborate on it don't use git, terminals, or markdown syntax.

Generate markdown with Claude Code

Copy-paste into Google Docs to share

Collaborators make edits in Google Docs

Copy changes back and feed them into Claude Code

MainStreet eliminates this round-trip. Your repo files are directly accessible in a rich editor anyone can use, and changes sync back automatically.

Getting Started

Set up in under a minute

1
Sign in with your GitHub account at mainstreet.ink/login.
2
Create an organization — this is the workspace where your projects and teammates live.
3
Create a project. Each project maps to a set of documents (and optionally a GitHub repo).
4
Start writing — or connect a GitHub repo to pull in your existing markdown files.

Connect GitHub

Link your repo so changes flow both ways

1
Open Project Settings → GitHub and connect a repository. MainStreet installs as a GitHub App with scoped permissions.
2
Choose a directory in your repo (e.g. /docs or /research) to sync with. Existing markdown files are imported automatically.
3
From here, edits in MainStreet push to GitHub and edits in GitHub appear in MainStreet. The sync is bi-directional and automatic.
4
When both sides change the same file, MainStreet performs a three-way merge. Conflicts surface in the Sync page where you choose which version to keep.

This is the key integration — it means your collaborators edit in MainStreet, and Claude Code sees the changes the next time it reads the repo. No manual shuttling of content between tools.

Invite Collaborators

Bring in the people who don't use git

1
Invite teammates to your organization from the org settings page. They sign in with GitHub or email — no terminal required.
2
Collaborators see a clean editor with a sidebar of pages. They can read, write, and comment without ever touching markdown syntax or git.
3
Their edits auto-save and sync to your GitHub repo. When they leave a comment or suggest an edit, it shows up right where you'd expect.
4
Use shareable links (see below) to give anyone view or comment access to a single page — no account needed.

The Editor

Rich editing that stays faithful to markdown

1
Click any page in the sidebar to open it. The editor is WYSIWYG — collaborators see formatted text, not raw markdown.
2
Use the toolbar or markdown shortcuts: # for headings, > for callouts, ``` for code blocks, --- for dividers. Everything round-trips cleanly to .md files.
3
Insert richer components from the toolbar: Mermaid diagrams, syntax-highlighted code blocks, callouts (note, tip, warning, danger), and tables.
4
Changes auto-save as you type. Version history lets you see or restore any previous state of a document.

Branching

Draft changes without affecting the live content

1
Create a branch from the branch switcher in the sidebar. Branches are isolated copies of your documentation.
2
Make changes on your branch — add pages, edit content, reorganize. The main branch stays untouched.
3
When ready, open a change request. Reviewers see a diff of everything that changed, page by page.
4
After approval, merge the branch. All changes apply to main at once.

Free Publish

Share any markdown file — no account needed

Sometimes you just need to share a document quickly. Free Publish lets you send any markdown file from a Claude Code session to a permanent, shareable URL — no sign-up, no setup, completely free. Useful for sharing research, meeting notes, or quick write-ups with anyone who has a browser.

How it works

1
Install the MainStreet publish skill in Claude Code (one-time setup — see commands below).
2
Ask Claude to publish any markdown file. It uploads the content and returns a permanent URL at mainstreet.ink/p/your-slug.
3
Share the link. Readers can leave comments directly on the page — useful for collecting feedback from your team.
4
Re-publish anytime to update the content. The URL stays the same; the content refreshes instantly.

Install the skill

Run in your terminal

curl -s https://mainstreet.ink/skill/SKILL.md | claude skill add

Then in any Claude Code session

You: Publish README.md to MainStreet
Claude: Published! → mainstreet.ink/p/your-readme

What you get

No account needed

Publish from any Claude Code session. No sign-up, no API key, no configuration.

Collect comments

Readers leave feedback directly on the page. See what your team thinks before you finalize.

Update anytime

Re-publish to refresh content. Same URL, new version — readers always see the latest.

Ready to close the loop?

Connect your repo and invite your team, or share something right now with the free Claude Code skill.