ShovelDocs
Get started
ShovelDocs
A collaborative editor for humans and AI
Write together. See who wrote what.
How it works
1. Create a doc
Click "Get started" or create one with the API. Your doc gets a shareable link.
2. Share with agents & humans
Paste the link into any AI agent—your Claw, Claude Code, ChatGPT, Codex—or share it with human collaborators.
3. Collaborate
Agents suggest edits and leave comments. You accept, reject, or reply. Each character tracks who wrote it.
Connect your agent
Use ShovelDocs in your browser — no install needed.
Get Cursor
or set up your agent
Any Agent
Claude Code
Codex
Cursor
Windsurf
# Quick start: click "Get started" above, then paste the doc URL into your agent.
export SHOVELDOCS_BASE_URL="${SHOVELDOCS_BASE_URL:-https://docs.luckyshovel.com}"
# Optional: install the ShovelDocs skill (if your agent supports skills)
# Skill URL: $SHOVELDOCS_BASE_URL/shoveldocs.SKILL.md
# Claude Code:
# mkdir -p ~/.claude/skills/shoveldocs && curl -fsSL "$SHOVELDOCS_BASE_URL/shoveldocs.SKILL.md" -o ~/.claude/skills/shoveldocs/SKILL.md
# Codex:
# mkdir -p ~/.codex/skills/shoveldocs && curl -fsSL "$SHOVELDOCS_BASE_URL/shoveldocs.SKILL.md" -o ~/.codex/skills/shoveldocs/SKILL.md
# 1. Create a document (returns slug + token)
curl -sS -X POST "$SHOVELDOCS_BASE_URL/documents" \
-H "Content-Type: application/json" \
-d '{"title":"My Doc","markdown":"# Hello\n\nFirst draft."}'
# Response includes: slug, accessToken
# Use these in the next steps.
# 2. Read it back
curl -H "Accept: application/json" \
"$SHOVELDOCS_BASE_URL/d/<slug>?token=<token>"
# 3. Suggest an edit (human accepts or rejects)
curl -sS -X POST "$SHOVELDOCS_BASE_URL/documents/<slug>/ops" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{"type":"suggestion.add","kind":"replace","quote":"First draft.","content":"First draft, revised.","by":"ai:my-agent"}'
# "by" tracks provenance — set it to "ai:<your-agent-name>"
Read https://docs.luckyshovel.com/agent-setup and follow all the instructions to install the ShovelDocs skill and configure yourself for persistent collaboration. Ask me before making config changes.
Read https://docs.luckyshovel.com/codex-agent-setup and follow all the instructions to install the ShovelDocs skill and configure yourself for persistent collaboration, including document creation via POST /documents. Ask me before making config changes.
Read https://docs.luckyshovel.com/agent-setup and follow all the instructions to install the ShovelDocs skill and configure yourself for persistent collaboration. Ask me before making config changes.
Read https://docs.luckyshovel.com/agent-setup and follow all the instructions to install the ShovelDocs skill and configure yourself for persistent collaboration. Ask me before making config changes.