tina4-ai

This Is Now A 4Framework

AI tools for the Tina4 family. Zero third-party dependencies.

Tools • Install • mdview • tina4.com

---

Tools

Tool	Description
mdview	Standalone Markdown viewer — renders .md files in the browser with full GFM support, live reload, and a file browser sidebar

---

Install

The recommended way — installs mdview as a standalone CLI tool:

uv tool install tina4-ai

Or with pipx:

pipx install tina4-ai

Or into a specific project/virtualenv:

pip install tina4-ai

---

mdview

A zero-dependency Markdown viewer. Opens any .md file in your default browser with full GitHub Flavored Markdown rendering, a file browser sidebar, and live reload on save.

Features:

• GFM: tables, task lists, strikethrough, fenced code blocks
• Syntax highlighting for 15+ languages
• File browser sidebar — navigate .md files in your project
• Live reload — browser updates automatically when you save
• Dark theme (GitHub Dark Dimmed)
• Zero pip dependencies — stdlib Python + vendored JS

Usage

mdview README.md                  # Open a specific file
mdview /path/to/directory         # Browse .md files in a directory
mdview                            # Browse current directory

Quick Start

uv tool install tina4-ai
mdview README.md

Your browser opens automatically. Edit the file and the browser refreshes.

With Claude Code

When working in Claude Code, ask Claude to open any Markdown file:

Show me that plan file

Claude runs mdview /path/to/file.md and it opens in your browser instantly.

File Browser

The sidebar lists all .md files and directories in your project. Click a directory to expand it, click a file to render it. Hidden directories and common build artefacts (.git, node_modules, vendor, __pycache__, .venv) are excluded automatically.

Security

• Binds to 127.0.0.1 only — never exposed on the network
• Path traversal protection — requests outside the project root are rejected
• Only .md files are served via the content endpoint

---

License

MIT (c) 2026 Tina4 Stack https://opensource.org/licenses/MIT

---

Tina4 — The framework that keeps out of the way of your coding.

---

Our Sponsors

Sponsored with 🩵 by Code Infinity

Supporting open source communities • Innovate • Code • Empower