gist-post
Post any content — summaries, plans, reports, pitches, logs — to GitHub Gist and share the URL. A lightweight way for agents to publish rich context that humans and other agents can read from anywhere.
Why Gists?
Agents communicate through messages, but messages disappear into scroll. A gist is:
- - Persistent — stays at a stable URL
- Readable by anyone — no auth required for public gists
- Markdown-rendered — GitHub renders it beautifully
- Shareable — paste the URL anywhere
When an agent needs to hand off context to a human, another agent, or a future session — a gist beats a wall of chat text.
Setup
You need a GitHub Personal Access Token scoped to gist, set as GITHUB_TOKEN in your environment. Ask your agent to walk you through creating one if you haven't already.
How to Post a Gist
Use the exec tool to call gh gist create:
CODEBLOCK0
Use --secret instead of --public if the content shouldn't be publicly indexed.
The command returns the gist URL on success:
✓ Created public gist FILENAME.md
https://gist.github.com/USERNAME/HASH
Workflow
- 1. Prepare content — write your markdown
- Choose visibility —
--public or INLINECODE7 - Post it — run
gh gist create via INLINECODE9 - Return the URL — share it in the conversation, send it to another agent, or log it
Tips
- - Use
.md extension in --filename so GitHub renders markdown - Write a meaningful
--desc — it's searchable - Update an existing gist: INLINECODE13
- List your gists: INLINECODE14
Gists: the simplest way for a claw to leave a note the world can read.gist-post
将任何内容——摘要、计划、报告、提案、日志——发布到GitHub Gist并分享链接。这是一种轻量级的方式，让智能体能够发布丰富的上下文信息，供人类和其他智能体随时随地阅读。
为什么选择Gist？
智能体通过消息进行通信，但消息会随着滚动而消失。而Gist具有以下特点：
- - 持久化 —— 保存在稳定的URL地址
- 任何人可读 —— 公开Gist无需身份验证
- Markdown渲染 —— GitHub会精美地渲染内容
- 可分享 —— 可粘贴到任何地方
当智能体需要将上下文传递给人类、其他智能体或未来的会话时——Gist比一长串聊天文本更胜一筹。
配置
你需要一个权限范围为gist的GitHub个人访问令牌，并在环境中设置为GITHUB_TOKEN。如果尚未创建，请让智能体引导你完成创建过程。
如何发布Gist
使用exec工具调用gh gist create命令：
bash
gh gist create --public --desc 描述信息 --filename 文件名.md - << EOF
你的内容在这里
支持Markdown格式。
EOF
如果内容不应被公开索引，请使用--secret替代--public。
命令成功执行后会返回Gist的URL：
✓ 已创建公开Gist 文件名.md
https://gist.github.com/用户名/HASH
工作流程
- 1. 准备内容 —— 编写你的Markdown
- 选择可见性 —— --public或--secret
- 发布内容 —— 通过exec运行gh gist create
- 返回链接 —— 在对话中分享、发送给其他智能体或记录保存
小贴士
- - 在--filename中使用.md扩展名，以便GitHub渲染Markdown
- 编写有意义的--desc描述——它是可搜索的
- 更新现有Gist：gh gist edit GIST_ID
- 列出你的Gist：gh gist list
Gist：一只爪子给世界留下便签的最简单方式。
