CLAUDE.mdA

CLAUDE.md from ximing/vital is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

Install it, pinned
mdr add ximing/vital/CLAUDE.md@git:20261021.2674a2a

Pins git:20261021.2674a2a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
CLAUDE.md file
Repository
ximing/vital
Path
CLAUDE.md
Versions recorded
5
Latest version
git:20261021.2674a2a, committed Oct 21, 2026
First version recorded
Sep 13, 2026
Size
5,720 bytes
Repository stars
3
License
none declared

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Vital — 项目指令

## 项目概览

Vital 是单用户、中文优先(`zh-CN`)、AI First 的个人操作系统(Inbox 收集 → Todos 执行 → Reports 复盘),采用 pnpm workspace + Turbo 构建(Node ≥ 22)。

- `apps/server`:Fastify 5 + Drizzle + PostgreSQL 后端 API(端口 `3010`)与后台 `worker`(Agent 调度、通知派发、正文抽取)
- `apps/web`:Vite + React 19 + Tailwind v4 + `@rabjs/react` 工作区(端口 `5180`)
- `apps/desktop`:Tauri 2 桌面端外壳(直接承载 `apps/web`)
- `apps/mobile`:Expo + React Native 移动端(Bearer 鉴权 + 增量同步)
- `apps/extension`:Chrome MV3 / WXT 浏览器收集扩展
- `packages/dto`:前后端共享的 Zod DTO 与复盘模板
- `packages/api-client`:面向各端复用的类型化 API Client 与同步合并工具
- `packages/tokens`:Emerald Garden 设计系统 Token(`theme.ts` 与 `css/semantic.css`)
- `packages/article-doc` / `article-extract` / `article-html` / `markdown`:正文文档结构、抽取与 Markdown 渲染
- `skills/vital`:供外部 Agent 通过 HTTP API 操作 Vital 数据的内置 Skill

## 全局基线规则

1. **数据库无外键**:PostgreSQL 表之间**不建外键**(禁止在 Drizzle schema 中使用 `.references()`)。归属校验(`user_id`)、存在性检查与父子级联清理均在服务层完成;跨表写入必须在同一个 `getDb().transaction` 中执行。
2. **收集箱正文隔离**:文章正文存储在 `inbox_item_bodies`(`@vital/article-doc` JSON + `extracted_text`,不存 HTML)。列表、同步与搜索响应省略正文;客户端合并同步数据时必须使用 `coalesceInboxBody`,防止冲掉已缓存的阅读器正文。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ximing/vital/CLAUDE.md@sha256:78b4bfacd16d9adc

The line at the top of this page pins the label git:20261021.2674a2a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7tacarixtb3qfjue.svg)](https://markdownregistry.com/a/art_7tacarixtb3qfjue)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Sep 13, 2026 and Oct 21, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261021.2674a2a latest2026-10-21 2674a2a 5,720 BA view · diff
git:20261017.74432da2026-10-17 74432da 3,104 BA view · diff
git:20260918.fe291fa2026-09-18 fe291fa 1,519 BA view · diff
git:20260918.6b86ccc2026-09-18 6b86ccc 1,195 BA view · diff
git:20260913.51dc0f72026-09-13 51dc0f7 1,099 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (5720 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ximing/vital · 3 stars · license none declared · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7tacarixtb3qfjue
GET https://markdownregistry.com/api/v1/resolve?ref=ximing/vital/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/78b4bfacd16d9adc09cb3b6b560e825d347807c34e1fa5f1cd94220a8d73dc3b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

More from ximing/vital

ximing-progressive-project SKILL.md skill
ximing/vital · .claude/skills/ximing-progressive-project/SKILL.md · 把现有项目重构为适合 Claude Code 的持久化指令渐进式加载架构。用户提到“拆分根 CLAUDE.md”、“按目录下沉规则”、“给当前项目设计分层指令文件”、“创建不同目录的 CLAUDE.md”、“补…
git:20261021.2674a2a · audit A · 3 stars
AGENTS.md AGENTS.md file
ximing/vital · AGENTS.md
git:20261017.74432da · audit A · 3 stars
CLAUDE.md@apps/extension CLAUDE.md file
ximing/vital · apps/extension/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/mobile CLAUDE.md file
ximing/vital · apps/mobile/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/server CLAUDE.md file
ximing/vital · apps/server/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/web CLAUDE.md file
ximing/vital · apps/web/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
vital SKILL.md skill
ximing/vital · skills/vital/SKILL.md · Operate the user's Vital personal OS (today, inbox, tasks, threads, habits, days, lists, tags, reports, search) through…
git:20260930.747d60d · audit B · 3 stars

Every file in ximing/vital

Other files named CLAUDE.md

CLAUDE.md CLAUDE.md file
affaan-m/ecc · CLAUDE.md
git:20260528.04c68e4 · audit A · 284,510 stars
CLAUDE.md CLAUDE.md file
firecrawl/firecrawl · CLAUDE.md
git:20261008.5a75dca · audit A · 193,096 stars
CLAUDE.md CLAUDE.md file
garrytan/gstack · CLAUDE.md
git:20261011.5d64745 · audit A · 136,966 stars
CLAUDE.md CLAUDE.md file
juliusbrussee/caveman · CLAUDE.md
git:20261010.505ac30 · audit B · 113,780 stars
CLAUDE.md CLAUDE.md file
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 109,013 stars
CLAUDE.md CLAUDE.md file
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 102,533 stars
CLAUDE.md CLAUDE.md file
thedotmack/claude-mem · CLAUDE.md
git:20261013.84bbb53 · audit A · 102,153 stars
CLAUDE.md CLAUDE.md file
egonex-ai/understand-anything · CLAUDE.md
git:20260710.6677c67 · audit B · 87,696 stars

Browse by kind, by grade A, or by owner.