mindos-max

Manages a local Markdown knowledge base via the MindOS CLI for shared agent memory.

664|58|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/GeminiLight/MindOS --skill mindos-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mindos-max
Source: https://github.com/GeminiLight/MindOS/tree/main/skills/mindos-max
Command: npx skills add https://github.com/GeminiLight/MindOS --skill mindos-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @geminilight/mindos.

What problem does it solve?

AI agents lose context between sessions, forcing users to repeat decisions, debugging lessons, and project conventions. This Skill turns a local MindOS knowledge base into a persistent shared memory layer that every connected agent can search, read, and update.

Core Features & Use Cases

  • Proactive memory management: Search the knowledge base before answering questions about past work, and offer to save decisions, debugging lessons, and meeting summaries after meaningful work.
  • Full file operations via CLI: List, read, create, append, edit sections, append CSV rows, rename, delete, and search Markdown files using the mindos command-line tool.
  • Structured workflows: Decision trees for read-only lookups, single-file edits, multi-file routing, Inbox staging and organization, SOP execution, retrospectives, and knowledge health checks.
  • Use Case: After a long debugging session, the agent proactively asks to save the root cause and fix to MindOS, then files it under the right directory so the next agent session can retrieve it instantly.

Quick Start

Ask the agent to search MindOS for any past notes about a topic, then save the current session's key decisions to the knowledge base.

Frequently Asked Questions about mindos-max

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save notes and decisions to a shared knowledge base for AI agents?

Use the mindos CLI commands such as mindos file create or mindos file append to write Markdown notes into the knowledge base. The Skill proactively offers to save decisions, debugging lessons, and summaries after meaningful work so agents can retrieve them later.

How do I search past notes and decisions with MindOS?

Run mindos search with your query, firing 2-4 parallel searches with synonyms or language variants for better recall. Results include file paths so answers can cite the exact source notes in the knowledge base.

How do I install and set up the MindOS CLI?

Install it globally with npm install -g @geminilight/mindos, then run mindos onboard to configure the knowledge root. For remote mode, set the server URL and auth token with mindos config set.

Can MindOS work with MCP tools instead of the CLI?

Yes, if you only have MCP tools (mindos_*), you can use them directly since they are self-describing via their schemas. The CLI is preferred when available because it has lower token cost.

What should I do when mindos commands fail with connection or auth errors?

For 'command not found', reinstall the npm package. For 'Mind root not configured', run mindos onboard. A 401 error means checking the auth token with mindos token on the server, and ECONNREFUSED means starting the server with mindos start.

When should files go to the MindOS Inbox instead of a specific folder?

Use Inbox when the user gives no clear destination, says to just save something, or when content does not fit any existing directory. Files in Inbox older than 7 days are flagged as aging and can be batch-organized later with user approval.