Share what Gemini CLI wrote
Gemini CLI is generous with output. Ask it to compare three approaches to a schema migration and you get something genuinely worth circulating — laid out in a terminal, on your machine, in a buffer that scrolls away.
The usual next steps all cost something. A screenshot captures a third of it.
A paste into Slack flattens the comparison table into ragged text. > report.md
produces a file whose only reader is whoever you email it to, and email is
where documents go to be ignored.
Attach the server, then write it down
Comma is a remote MCP server, so setup is an httpUrl entry — the full block
is in Gemini CLI setup, and the token comes from
API tokens:
{
"mcpServers": {
"comma": {
"httpUrl": "https://commareports.com/api/mcp",
"headers": { "Authorization": "Bearer comma_sk_..." }
}
}
}
Then put the standing instruction in GEMINI.md, which the agent loads on
every run:
Finished work that a human needs to read — comparisons, audits, migration
plans, weekly digests — gets published to Comma as an HTML report. Reply with
the URL only. Reuse the report id in `.gemini/comma-report-id` so the link
stays stable across runs.
Non-interactive runs benefit most
An interactive session has you watching it. A cron entry does not:
gemini -p "Summarise this week's API latency regressions and publish the \
report to Comma. Reply with only the URL."
One line of output, one URL, one page the on-call engineer can actually open. If the run belongs in a pipeline see CI reports; if you would rather not own the scheduler at all, see routines.
What the report gives you that the terminal does not
- Rendering that survives. Tables, code blocks and embedded charts arrive as the agent wrote them, in a sandboxed iframe.
- A stable address. The link you pasted last Tuesday still resolves, and the version behind it is in the revision history.
- Anchored replies. A reviewer highlights the one number they doubt rather than describing which paragraph they mean — see commenting on HTML.
- A read path back. The agent can pull the open threads through the same server and act on them — see letting an agent respond to comments.
Worth knowing
- Scope the token.
reports:writefor publishing; nothing else is needed to make this work. See scoped tokens. - 5 MB of HTML per report body.
- A report is a snapshot. No re-execution, no live query, no surprise cost when forty people open it.
Try it
Free, with unlimited reports, commenters and revisions.