{
  "markdown": "# Markviewz\n\nA lightweight, native macOS markdown viewer built for the AI-assisted development workflow.\n\n## The Problem\n\nCLI-based AI assistants (Claude Code, Codex, Aider, etc.) generate and work with `.md` files constantly — README files, documentation, changelogs, specs, reports. But reading raw markdown in the terminal is painful, and most markdown apps are heavyweight editors when all you need is a *viewer*.\n\n## The Solution\n\nMarkviewz is a read-only markdown viewer that stays out of your way. Open a file from the terminal, read it with proper formatting, get back to work.\n\n```bash\nmarkviewz README.md\n```\n\nThat's it. No editing, no bloat, no Electron. Just a native Mac app that renders your markdown beautifully.\n\n## Features\n\n- **GitHub-flavored markdown** — tables, task lists, strikethrough, autolinks\n- **YAML frontmatter** — collapsed by default, click to expand\n- **Dark mode** — follows system automatically\n- **Local images** — relative image paths just work\n- **Print support** — Cmd+P to print or export to PDF\n- **Multiple open methods** — CLI, Cmd+O, drag-and-drop, Finder, `open -a`\n- **Single instance** — opening a new file reuses the running app and brings it to front\n- **GitHub-style typography** — clean, readable CSS\n\n## Install\n\n### Claude Code Plugin (recommended)\n\nIf you use [Claude Code](https://claude.com/claude-code), install Markviewz as a plugin to get the `/markviewz` skill:\n\n```\n/plugin marketplace add daveremy/claude-plugins\n/plugin install markviewz@daveremy-plugins\n```\n\nOr install directly from this repo's marketplace:\n\n```\n/plugin marketplace add daveremy/Markviewz\n/plugin install markviewz@markviewz\n```\n\nThen ask Claude to \"show me the README\" or use `/markviewz README.md`. If the binary isn't installed yet, Claude will guide you through the install.\n\n### Gemini CLI Extension\n\nIf you use [Gemini CLI](https://github.com/google-gemini/gemini-cli), install the extension:\n\n```\ngemini extensions install https://github.com/daveremy/Markviewz.git\n```\n\n### Codex CLI Skill\n\nIf you use [Codex CLI](https://github.com/openai/codex), ask Codex to install the skill:\n\n```\ninstall the markviewz skill from daveremy/Markviewz at path codex/markviewz\n```\n\n### npm\n\nRequires macOS 14+ and Swift 5.9+.\n\n```bash\nnpx -y markviewz\n```\n\nThis clones the repo, builds a release binary, creates `Markviewz.app` in `/Applications`, and installs a `markviewz` CLI wrapper.\n\n### Manual Install\n\n```bash\ngit clone https://github.com/daveremy/Markviewz.git\ncd Markviewz\n./install.sh\n```\n\n## Usage\n\n```bash\n# From Claude Code\n/markviewz README.md\n\n# From the terminal (reuses running instance)\nmarkviewz notes.md\n\n# Or use macOS open command\nopen -a Markviewz spec.md\n\n# Launch and use Cmd+O to browse\nmarkviewz\n```\n\nYou can also drag and drop `.md` files onto the window.\n\n## Building from Source\n\n```bash\nswift build              # debug build\nswift build -c release   # optimized release build\nswift test               # run tests (when available)\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute, our git workflow, and coding standards.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3151,
  "sha": "87802bce073075fcf81745062f1e5d1e954c587df1d9e4b539a590c730cbaa70",
  "repo_slug": "daveremy/markviewz",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_daveremy_markviewz_e6c8ae98/readme"
}