fastmd

fastmd.dev

Minimalist CLI-first Markdown hosting for developers and AI agents.

fastmd lets you push Markdown from terminal to a short URL in milliseconds. The same document can be consumed by humans as HTML and by machines as raw Markdown.

cat report.md | fastmd
# -> https://fastmd.dev/x7y2

Latest Update (v0.3.0 in progress)

• Added 8-character IDs for new documents
• Added token-authenticated /v1/docs API and web Dashboard
• Added IP rate limiting and dashboard management flow

Install

Install fastmd Skill

No Python or CLI dependency required. The skill only needs sh and curl.

curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh

Targets installed by default:

• Claude Code: ~/.claude/skills/fastmd
• OpenCode: ~/.config/opencode/skills/fastmd
• Codex: ~/.codex/skills/fastmd

Install only one client:

curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --claude
curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --opencode
curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --codex

Install fastmd CLI

curl -fsSL https://fastmd.dev/install.sh | sh

Supported platforms:

• macOS: arm64, amd64
• Linux: arm64, amd64

Quick Start

Publish

# Pipe mode
cat report.md | fastmd

# File mode
fastmd push report.md

Agent skill

If you use the fastmd skill in an agent environment, the skill name is just fastmd.

Expected behavior:

• first run auto-generates a local token like fmd_live_xxxx
• the skill pushes the Markdown report to fastmd.dev directly, without requiring CLI installation
• the final result is one short URL instead of a huge inline report

Typical flow:

agent finishes report -> fastmd skill loads token -> push succeeds -> URL returned

Dashboard

Open https://fastmd.dev/dashboard, paste your fmd_live_ token, and manage every document tied to that token.

• list published docs
• copy document URLs
• delete documents from the browser

Pull raw markdown

fastmd get x7y2

Delete

fastmd delete x7y2

Upgrade

fastmd upgrade

Core Use Cases

1. AI External Display Large agent output is published to a clean web view instead of flooding terminal history.

2. Seamless Agent Handoff Use /:id.md to pass structured context between local and remote agents.

3. Stealth Doc Sharing Share internal docs quickly while keeping distribution controlled.

4. CI/CD Debug Snapshots Pipe failed build/test logs to a short URL for team debugging.

5. Remote Prompt Control Host prompt/state markdown centrally and let remote workers pull updates.

6. Instant Skill Report Sharing Pipe AI skill outputs (SEO audits, content drafts, reports) to fastmd and share a clean private link in milliseconds.

REST API

POST /v1/push

curl -X POST https://fastmd.dev/v1/push \
  -H "Content-Type: application/json" \
  -d '{"content":"# Hello\nWorld","token":"fmd_live_xxxx"}'

Response:

{"id":"Ab3kL9xQ","url":"https://fastmd.dev/Ab3kL9xQ"}

GET /v1/docs

curl https://fastmd.dev/v1/docs \
  -H "Authorization: Bearer fmd_live_xxxx"

Response:

{
  "documents": [
    {
      "id": "Ab3kL9xQ",
      "title": "Weekly Report",
      "created_at": 1710000000,
      "url": "https://fastmd.dev/Ab3kL9xQ"
    }
  ]
}

GET /:id

Human-friendly HTML view.

GET /:id.md

Raw Markdown view for agents and scripts.

DELETE /v1/:id

curl -X DELETE https://fastmd.dev/v1/Ab3kL9xQ \
  -H "Authorization: Bearer fmd_live_xxxx"

GET /v1/version

curl https://fastmd.dev/v1/version

Token & Privacy Model

• First run generates token like fmd_live_xxxx
• Token is saved locally at ~/.config/fastmd/token
• Server stores only token hash (SHA-256), never raw token
• Token ownership controls delete permission
• Detail/raw pages return no-index directives for privacy-first sharing

Skill flow follows the same model: first use bootstraps the token locally, and later pushes reuse the same token automatically.

Skill and CLI are separate products, but they share the same local token file at ~/.config/fastmd/token.

Dashboard uses the same token model. Paste the token in the browser to manage the document list for that identity.

Skill Source

• Skill source: skills/fastmd
• Installer: install-skill.sh
• Main skill entry: skills/fastmd/SKILL.md
• Runtime helper: skills/fastmd/scripts/publish.sh

Self-Hosting

git clone https://github.com/wonfull888/fastmd.git
cd fastmd
make build-server
./dist/fastmd-server --port 8080 --db ./data/fastmd.db

Reverse proxy example (Caddy):

fastmd.yourdomain.com {
    reverse_proxy localhost:8080
}

Release

See:

• CHANGELOG.md
• RELEASE_v0.2.1.md
• RELEASE_v0.2.0.md
• RELEASE_v0.1.2.md

License

MIT