knowledge-os

v0.7.0

Approval-gated conversational capture and task-relevant repository documentation for Knowledge OS durable Markdown records, with explicit one-time global and repository initialization when needed.

CodexClaude Code4 Skills1 MCP serverstdio

By Sockulags0 GitHub starsUpdated 2 hours ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 5 skill or MCP entries
Source updated: Sep 25, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install knowledge-os for Codex and Claude Code

Installs for the current user

codex plugin marketplace add sockulags/knowledge-os
codex plugin marketplace upgrade knowledge-os
codex plugin add knowledge-os@knowledge-os

Paste and run these commands in a terminal with Codex. They add and refresh the knowledge-os catalog, then install this plugin.

Compatibility: the page URL and API slug “knowledge-os” remain stable.

Codex: knowledge-os@agent-plugin-marketplace → knowledge-os@knowledge-os

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/sockulags/knowledge-os

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

knowledge-os/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/ingest-source/SKILL.md
├── skills/knowledge-os-capture/SKILL.md
├── skills/knowledge-os-documentation/SKILL.md
├── skills/review-discovery/SKILL.md
└── .mcp.json

Included Skills4

ingest-sourceskills/ingest-source/SKILL.md

Ingest one local Markdown or text source into Knowledge OS while preserving provenance and validating the resulting durable record.

knowledge-os-captureskills/knowledge-os-capture/SKILL.md

Detects durable decisions, reusable lessons, and recurring user preferences in ordinary conversations, then batches approval-gated proposals and captures only approved records in a configured Knowledge OS workspace. Not for chatter, tentative ideas, one-off tasks, transient facts, or unverified claims.

knowledge-os-documentationskills/knowledge-os-documentation/SKILL.md

Initializes and maintains repository documentation retrieval through Knowledge OS without treating search results as verified or writing without authorization.

review-discoveryskills/review-discovery/SKILL.md

Decide whether an external-agent observation should remain a reviewed discovery, be rejected, or be promoted into a new draft without bypassing the Knowledge OS trust boundary.

MCP servers1

knowledge-osstdio

command: kos
args: mcp

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "knowledge-os",
  "version": "0.7.0",
  "description": "Approval-gated conversational capture and task-relevant repository documentation for Knowledge OS durable Markdown records, with explicit one-time global and repository initialization when needed.",
  "author": {
    "name": "Sockulags",
    "url": "https://github.com/sockulags"
  },
  "homepage": "https://github.com/sockulags/knowledge-os",
  "repository": "https://github.com/sockulags/knowledge-os",
  "keywords": [
    "knowledge",
    "memory",
    "capture",
    "conversation",
    "documentation",
    "projects"
  ],
  "skills": "./skills/",
  "mcpServers": "./.codex-plugin/mcp.json",
  "interface": {
    "displayName": "Knowledge OS",
    "shortDescription": "Approved capture and repository documentation",
    "longDescription": "Detect durable decisions, reusable lessons, and recurring preferences in conversation, batch proposals at natural pauses, and capture only approved records in a configured Knowledge OS workspace. Initialize global host guidance or repository project bindings when explicitly requested, then retrieve and maintain task-relevant documentation without treating search results as verified.",
    "developerName": "Sockulags",
    "category": "Productivity",
    "capabilities": [
      "Detect durable conversation candidates",
      "Capture approved Knowledge OS records",
      "Initialize global Codex and Claude documentation guidance",
      "Initialize repository project bindings",
      "Retrieve and maintain task-relevant documentation",
      "Search, write notes, and propose decisions through the running Knowledge OS app"
    ],
    "defaultPrompt": [
      "Capture durable decisions only after I approve them."
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "knowledge-os",
  "description": "Approval-gated conversational capture and task-relevant repository documentation for Knowledge OS durable Markdown records, with explicit global and repository initialization.",
  "version": "0.7.0",
  "author": {
    "name": "Sockulags",
    "url": "https://github.com/sockulags"
  },
  "skills": "./skills/",
  "mcpServers": {
    "knowledge-os": {
      "command": "kos",
      "args": [
        "mcp"
      ]
    }
  }
}