{
  "version": "2",
  "generatedAt": "2026-11-03T22:49:39.280Z",
  "listing": {
    "slug": "refactoringhq--tolaria",
    "name": "Tolaria",
    "tagline": "Files-first markdown second brain with git built in and an in-repo MCP server for Claude Code and Codex.",
    "shortTagline": "Files-first markdown second brain",
    "description": "Tolaria is a desktop app for macOS, Windows, and Linux that manages a vault of markdown notes with YAML frontmatter, each vault a git repository. The Builder bundles an MCP server (mcp-server/) that lists and attaches vaults and lets an agent search, read, create, update, and open notes in the running app.",
    "capabilities": [
      "operable"
    ],
    "vertical": "notes-knowledge",
    "alternativeTo": [
      "Notion",
      "Obsidian"
    ],
    "shape": "business-app",
    "formFactor": "desktop",
    "executionModel": "hybrid",
    "provenance": "mixed",
    "codeStack": {
      "languages": [
        "TypeScript",
        "JavaScript"
      ],
      "frameworks": [
        "Vite"
      ],
      "packageManager": "npm",
      "database": [],
      "hostingTarget": [
        "local"
      ]
    },
    "modelStack": {
      "providers": [
        "local agents (Claude Code, Codex, OpenCode, Pi, Gemini CLI)",
        "API model providers for in-app chat"
      ],
      "models": [],
      "requiredKeys": [],
      "promptLocations": [],
      "tools": [
        "list_vaults",
        "attach_vault",
        "clone_vault",
        "refresh_vault",
        "get_vault_context",
        "search_notes",
        "get_note",
        "create_note",
        "update_note",
        "append_to_note",
        "open_note"
      ]
    },
    "repos": [
      {
        "url": "https://github.com/refactoringhq/tolaria",
        "owner": "refactoringhq",
        "name": "tolaria",
        "license": "AGPL-3.0",
        "stars": 19671,
        "lastCommit": "2026-09-03"
      }
    ],
    "interface": {
      "kind": "mcp",
      "url": "https://github.com/refactoringhq/tolaria/tree/main/mcp-server",
      "official": true,
      "hosted": "local"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Create, read, update, and append to notes",
        "reachable": true,
        "evidence": "create_note, get_note, update_note, append_to_note in mcp-server/index.js"
      },
      {
        "job": "Search notes",
        "reachable": true,
        "evidence": "search_notes tool"
      },
      {
        "job": "Manage vaults (list, attach, clone, refresh)",
        "reachable": true,
        "evidence": "list_vaults, attach_vault, clone_vault, refresh_vault"
      },
      {
        "job": "Open a note in the app",
        "reachable": true,
        "evidence": "open_note tool over the ws-bridge to the desktop app"
      },
      {
        "job": "Types and note relationships",
        "reachable": null,
        "evidence": "get_vault_context likely returns vault metadata; not verified"
      },
      {
        "job": "Git commit, push, and history",
        "reachable": false,
        "evidence": "no git tool in mcp-server; the vault is a plain git repo an agent can drive with shell"
      },
      {
        "job": "In-app AI chat over note context",
        "reachable": false,
        "evidence": "human UI feature"
      },
      {
        "job": "Inbox and web-resource capture",
        "reachable": false,
        "evidence": "walkthroughs describe UI workflows; no capture tool"
      }
    ],
    "editions": [
      {
        "name": "Free",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/refactoringhq/tolaria"
          },
          {
            "kind": "binary",
            "url": "https://github.com/refactoringhq/tolaria/releases"
          }
        ]
      }
    ],
    "skills": {
      "kind": "none",
      "paths": [],
      "install": null,
      "note": "No SKILL.md, Claude Code plugin, or published skill found in the repo."
    },
    "customization": null,
    "useWhen": [
      "you want your notes as plain markdown in git and an agent that can search and write them from Claude Code",
      "you run a 10,000-note personal vault and want keyboard-first navigation with AI on the side"
    ],
    "accounts": [],
    "active": true,
    "lastActivity": "2026-09-03",
    "gotchas": [
      "AGPL-3.0-or-later",
      "The MCP server talks to the running desktop app over a websocket bridge; open_note and vault attach need the app open",
      "No paid or hosted edition; sync is whatever git remote you choose"
    ],
    "fit": {
      "adaptable": 1,
      "operable": 3
    },
    "evidence": {
      "formFactor": "README: desktop app for macOS, Windows, and Linux",
      "executionModel": "tolaria.md: chat with local or API model providers over note context; note editing needs no model",
      "operability": "mcp-server/ directory in the same repo; tool names read from mcp-server/index.js",
      "effort": ".env.example holds only LARA_ACCESS_KEY_ID, LARA_ACCESS_KEY_SECRET, VITE_POSTHOG_KEY, VITE_POSTHOG_HOST, VITE_SENTRY_DSN: build-time telemetry, not a behavior surface for an Adopter, so Adaptable is not claimed",
      "editions": "tolaria.md: 'Free forever', no account; releases on GitHub",
      "active": "pushedAt 2026-09-03; Show HN 2026-04-23 with 318 points",
      "provenance": "README: sponsors keep the project 'ready for AI-assisted development'; CLAUDE.md and AGENTS.md at root"
    },
    "confidence": {
      "formFactor": 0.95,
      "executionModel": 0.7,
      "operability": 0.9,
      "effort": 0.7,
      "reach": 0.85,
      "editions": 0.9,
      "provenance": 0.5
    },
    "openQuestions": [
      "Does get_vault_context expose types and relationships?",
      "Is there an app-level config file (mcp-server/app-config-policy.json suggests a policy surface) that would justify an Adaptable capability?"
    ],
    "sources": [
      {
        "url": "https://github.com/refactoringhq/tolaria",
        "foundBy": "sourcing:notes-knowledge:community"
      },
      {
        "url": "https://tolaria.md",
        "foundBy": "analysis"
      },
      {
        "url": "https://github.com/refactoringhq/tolaria/blob/main/mcp-server/index.js",
        "foundBy": "analysis"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Official in-repo MCP covering note CRUD, search, and vault management on a real desktop product; re-derived as Operable-only because the .env.example is telemetry keys, not a customization surface.",
      "disputed": [
        "Triage scored Adaptable 2 on the basis of .env.example; analysis found only telemetry variables"
      ]
    },
    "url": "apps/refactoringhq--tolaria.html",
    "coverage": "partial",
    "paid": false,
    "source": "research/verified/refactoringhq--tolaria.json"
  }
}