mindos
Operate a MindOS knowledge base: update notes, search, organize files, execute SOPs/workflows, retrospective, append CSV, cross-agent handoff, route unstructured input to the right files, distill experience, sync related docs. Use when the task targets files inside the user's MindOS KB (mindRoot). NOT for editing app source, project docs, or paths outside the KB. Core concepts: Space, Instruction (INSTRUCTION.md), Skill (SKILL.md); notes can embody both. Trigger when user asks to: save or record a note, search their knowledge base, update or edit a file, organize notes, run a workflow or SOP,
npx skills add GeminiLight/MindOS --skill mindos-original --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.0.0 — 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
- NEVER do (hard-won pitfalls)
- MindOS concepts
- Decision tree
- Judgment heuristics
- Post-task hooks
- Preference capture
- SOP authoring
- Error handling (CLI)
npm install -g @geminilight/mindos Remote mode: mindos config set url http://<IP>:<PORT> && mindos config set authToken <token>
What does the mindos skill do?
Operate a MindOS knowledge base: update notes, search, organize files, execute SOPs/workflows, retrospective, append CSV, cross-agent handoff, route unstructured input to the right files, distill experience, sync related docs. Use when the task targets files inside the user's MindOS KB (mindRoot). NOT for editing app source, project docs, or paths outside the KB. Core concepts: Space, Instruction (INSTRUCTION.md), Skill (SKILL.md); notes can embody both. Trigger when user asks to: save or record a note, search their knowledge base, update or edit a file, organize notes, run a workflow or SOP,
How do I install it?
Run `npx skills add GeminiLight/MindOS --skill mindos-original --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.