# Tinymind

> Publish thoughts and Markdown articles to TinyMind through the user's GitHub-backed tinymind-blog repository. Use when the user asks to post, write, publish, or sync a TinyMind thought or article, or asks to use the tinymind or tm command-line interface.

- Skill: `mazzzystar/tinymind` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add mazzzystar/tinymind`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mazzzystar/tinymind/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: mazzzystar (https://skillmd.com/u/mazzzystar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mazzzystar/tinymind

---


# TinyMind

Publish with the bundled CLI. It writes through the authenticated GitHub CLI and commits directly to the target `tinymind-blog` repository.

## Before publishing

1. Require an explicit user request to publish because every successful command creates a GitHub commit immediately.
2. Run `gh auth status` if authentication is uncertain.
3. Use the repository from `--repo owner/repo` or `TINYMIND_REPO`. Otherwise, let the CLI select `<authenticated-user>/tinymind-blog`.
4. Keep tokens out of commands and files; the CLI reuses `gh` authentication.

## Publish a thought

Pass the thought as positional text:

```bash
tm "今天天气真好"
tinymind "A short thought with **Markdown**."
```

Add an image with `--image`:

```bash
tm --image /path/to/photo.webp "A thought with an image"
```

## Publish an article

Provide both a title and content:

```bash
tm -t "你好" -c "文章正文"
tinymind --title "Long post" --file /path/to/post.md
```

The CLI generates safe YAML frontmatter and preserves Markdown, GFM, and math syntax in the body. It refuses to overwrite an existing slug unless the user explicitly supplies `--force`.

## Run without installation

If `tm` is unavailable, run the bundled script from this skill directory:

```bash
node scripts/tinymind.mjs "Your thought"
node scripts/tinymind.mjs -t "Title" -f /path/to/post.md
```

Use `--dry-run` to validate and preview without contacting GitHub. Use `--json` when machine-readable output is useful.

## Install the commands

Install the public package when the commands are unavailable:

```bash
npm install --global tinymind-cli
```

This installs `tinymind-cli`, `tinymind`, and the short alias `tm`. A TinyMind
source checkout or local web deployment is not required.