{
  "version": "2",
  "generatedAt": "2026-11-06T20:51:57.517Z",
  "listing": {
    "slug": "nico2sh--kimun",
    "name": "Kimun",
    "tagline": "Terminal Markdown notes app with search, a scriptable CLI and an MCP server.",
    "shortTagline": "Terminal notes with MCP",
    "description": "Kimun is a local-first Rust notes app for plain Markdown vaults with a TUI, a CLI and a built-in MCP server over stdio. The MCP server has 18 tools for notes, properties, links and journals plus 7 review prompts. An optional server adds semantic search and question answering over your notes.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "notes-knowledge",
    "alternativeTo": [],
    "shape": "product",
    "formFactor": "cli",
    "executionModel": "deterministic",
    "provenance": "unknown",
    "codeStack": {
      "languages": [
        "Rust"
      ],
      "frameworks": [
        "Ratatui"
      ],
      "packageManager": "cargo",
      "database": [
        "SQLite"
      ],
      "hostingTarget": [
        "local"
      ]
    },
    "modelStack": null,
    "repos": [
      {
        "url": "https://github.com/nico2sh/kimun",
        "owner": "nico2sh",
        "name": "kimun",
        "license": "MIT",
        "stars": 64,
        "lastCommit": "2026-11-02"
      }
    ],
    "interface": {
      "kind": "mcp",
      "url": "https://nico2sh.github.io/kimun/using-kimun/ai-mcp-server/",
      "official": true,
      "hosted": "local"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Create, append to and edit notes",
        "reachable": true,
        "evidence": "MCP tools create_note, append_note, overwrite_note, replace_in_note"
      },
      {
        "job": "Delete notes",
        "reachable": true,
        "evidence": "MCP tool delete_note (marked destructive, backed up first)"
      },
      {
        "job": "Search notes",
        "reachable": true,
        "evidence": "MCP tool search_notes; CLI kimun search"
      },
      {
        "job": "Read notes and list the vault",
        "reachable": true,
        "evidence": "MCP tools show_note, list_notes, get_chunks; notes also exposed as note:// resources"
      },
      {
        "job": "Follow links and backlinks",
        "reachable": true,
        "evidence": "MCP tools get_backlinks and get_outlinks"
      },
      {
        "job": "Read and set frontmatter properties",
        "reachable": true,
        "evidence": "MCP tools get_properties, set_property, remove_property"
      },
      {
        "job": "Rename and move notes with link updates",
        "reachable": true,
        "evidence": "MCP tools rename_note and move_note"
      },
      {
        "job": "Journal and quick capture to the inbox",
        "reachable": true,
        "evidence": "MCP tools journal and quick_note; CLI kimun journal append"
      },
      {
        "job": "Manage workspaces (vaults)",
        "reachable": false,
        "evidence": "No MCP tool in tui/src/cli/commands/mcp/mod.rs; the CLI covers it with kimun workspace init/list/use/rename/remove/reindex"
      },
      {
        "job": "Semantic search and Ask over notes",
        "reachable": false,
        "evidence": "No MCP tool or CLI command. The optional kimun-server exposes POST /api/answer and GET /api/job/{job_id} over HTTP with a bearer token"
      }
    ],
    "editions": [
      {
        "name": "Free",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "installable",
            "url": "https://kimun.2co.dev/install.sh",
            "command": "curl -fsSL https://kimun.2co.dev/install.sh | sh"
          },
          {
            "kind": "installable",
            "url": "https://github.com/nico2sh/kimun",
            "command": "brew tap nico2sh/kimun && brew install kimun"
          },
          {
            "kind": "installable",
            "url": "https://crates.io/crates/kimun-notes",
            "command": "cargo install kimun-notes"
          },
          {
            "kind": "container",
            "url": "https://github.com/nico2sh/kimun/pkgs/container/kimun-server",
            "command": "docker run -d --name kimun-server -p 7573:7573 -v kimun-server-data:/data ghcr.io/nico2sh/kimun-server:latest"
          },
          {
            "kind": "source",
            "url": "https://github.com/nico2sh/kimun"
          }
        ]
      }
    ],
    "skills": {
      "kind": "bundled",
      "paths": [
        "skills/kimun-cli/SKILL.md"
      ],
      "install": "cp -r skills/kimun-cli ~/.claude/skills",
      "note": "A kimun-cli skill teaches an agent the kimun CLI; the README gives the copy command."
    },
    "customization": {
      "summary": "config.toml sets theme, key bindings, leader-key tree, sort order, workspaces and the optional server URL. These are personal interface settings, not business behavior. The MCP review prompts are compiled into the Rust source (tui/src/cli/commands/mcp/prompts.rs), so changing them needs a code edit.",
      "envVars": [
        "KIMUN_INSTALL_DIR"
      ],
      "configFiles": [
        "config.toml"
      ],
      "promptFiles": [
        "tui/src/cli/commands/mcp/prompts.rs",
        "skills/kimun-cli/SKILL.md"
      ],
      "effort": "light-edit",
      "editCount": 4
    },
    "useWhen": [
      "you keep notes as Markdown files and want your agent to search, link and journal in them",
      "you live in a terminal and want an Obsidian-compatible vault with scriptable access"
    ],
    "accounts": [],
    "active": true,
    "lastActivity": "2026-11-02",
    "gotchas": [
      "README warns the app is in heavy development and config or themes may break after updates",
      "semantic search and Ask need the separate kimun-server and an embedding model download of a few hundred MB",
      "One person writes almost all the code; outside use is small but real",
      "The Docker image is the optional kimun-server, not the notes app"
    ],
    "fit": {
      "adaptable": 2,
      "operable": 3
    },
    "evidence": {
      "formFactor": "README: terminal-based notes app, TUI and CLI",
      "executionModel": "notes, search and MCP tools are code; Ask is an optional server with an LLM",
      "operability": "docs/content/using-kimun/ai-mcp-server.md lists 18 tools and 7 prompts; tui/src/cli/commands/mcp/mod.rs has 18 #[tool] entries; published by the same owner at nico2sh.github.io/kimun",
      "effort": "docs configuration.md and example/config.toml cover theme, key bindings, workspaces and paths only",
      "editions": "MIT; install script, Homebrew and Cargo in README; no price seen",
      "active": "GitHub commits API: last commit 2026-11-02; release kimun-notes-v0.24.7",
      "outsideUsers": "64 stars. Six issues from three outside authors between June and September 2026, with replies. A pull request and 7 commits from two other outside contributors. 5 forks. crates.io: 1,375 downloads, 336 recent"
    },
    "confidence": {
      "formFactor": 0.85,
      "executionModel": 0.8,
      "operability": 0.9,
      "effort": 0.7,
      "reach": 0.9,
      "editions": 0.85
    },
    "openQuestions": [
      "Provenance unknown"
    ],
    "sources": [
      {
        "url": "https://nico2sh.github.io/kimun/",
        "foundBy": "sourcing:notes-knowledge:community"
      }
    ],
    "published": true,
    "lastCheckedAt": "2026-11-06",
    "research": {
      "stage": "verified",
      "verdict": "approve",
      "reason": "Gates pass: MIT, commits on 2026-11-02, 64 stars, and outside users are real: three outside issue authors and two outside code contributors. MCP tools and CLI confirmed in source. Workspaces marked unreachable because they are CLI only, not MCP.",
      "disputed": []
    },
    "url": "apps/nico2sh--kimun.html",
    "coverage": "partial",
    "paid": false,
    "source": "research/verified/nico2sh--kimun.json"
  }
}