mindos
research findings, preferences across sessions/agents. Core: save notes, search KB, organize files, run workflows, review, append CSV, hand off context, distill lessons. NOT for app source or paths outside KB. Triggers: save/record, search notes, update files, organize, run workflow, capture decisions, append CSV, hand off context, check past discussions, distill lessons. (3) suggest persisting key decisions.
npx skills add GeminiLight/MindOS --skill mindos --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# MindOS Skill <!-- version: 3.3.1 — CLI-first, MCP optional --> ## CLI commands Use `mindos file <subcommand>` for all knowledge base operations. Add `--json` for structured output. | Operation | Command | |-----------|---------| | List files | `mindos file list` | | Read file | `mindos file read <path>` | | Write/overwrite | `mindos file write <path> --content "..."` | | Create new file | `mindos file create <path> --content "..."` | | Append to file | `mindos file append <path> --content "..."` | | Edit section | `mindos file edit-section <path> -H "## Heading" --content "..."` | | Insert after heading | `mindos file insert-heading <path> -H "## Heading" --content "..."` | | Append CSV row | `mindos file append-csv <path> --row "col1,col2,col3"` | | Delete file | `mindos file delete <path>` | | Rename/move | `mindos file rename <old> <new>` | | Search | `mindos search "query"` | | Backlinks | `mindos file backlinks <path>` | | Recent files | `mindos file recent --limit 10` | | Git history | `mindos file history <path>` | | List spaces | `mindos space list` | | Create space | `mindos space create "name"` | > **MCP users:** If you only have MCP tools (`mindos_*`), use them directl
- CLI commands
- CLI setup
- Rules
- Answer contract
- Retrieval strategy
- Path 1: Directory scan (by name/structure)
- Path 2: Full-text search (by content)
- Filter: snippet triage before full read
- Combined example
- NEVER do (hard-won pitfalls)
- MindOS concepts
- Decision tree
- Judgment heuristics
- Post-task hooks
npm install -g @geminilight/mindos Remote mode: mindos config set url http://<IP>:<PORT> && mindos config set authToken <token> mindos file create "Inbox/<filename>.md" --content "..."
What does the mindos skill do?
research findings, preferences across sessions/agents. Core: save notes, search KB, organize files, run workflows, review, append CSV, hand off context, distill lessons. NOT for app source or paths outside KB. Triggers: save/record, search notes, update files, organize, run workflow, capture decisions, append CSV, hand off context, check past discussions, distill lessons. (3) suggest persisting key decisions.
How do I install it?
Run `npx skills add GeminiLight/MindOS --skill mindos --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From GeminiLight/MindOS, a repository with 657 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.