{
  "slug": "io-github-phasespace-labs-palinode",
  "name": "io.github.phasespace-labs/palinode",
  "title": "Palinode",
  "description": "Inspectable, correctable project memory in git-versioned Markdown for AI agents.",
  "version": "0.23.0",
  "publishedAt": "2026-10-14T03:01:41.642624Z",
  "updatedAt": "2026-10-14T03:01:41.642624Z",
  "repoUrl": "https://github.com/phasespace-labs/palinode",
  "websiteUrl": "https://github.com/phasespace-labs/palinode",
  "namespace": {
    "type": "github",
    "owner": "phasespace-labs"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "pypi",
      "identifier": "palinode",
      "version": "0.23.0",
      "transport": "stdio",
      "runtimeHint": "uvx"
    },
    {
      "registryType": "pypi",
      "identifier": "palinode",
      "version": "0.23.0",
      "transport": "streamable-http",
      "runtimeHint": "uvx"
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "PALINODE_DIR",
      "isSecret": false,
      "isRequired": true,
      "description": "Path to the markdown-memory directory (e.g. ~/.palinode). Created if missing."
    },
    {
      "name": "PALINODE_API_HOST",
      "isSecret": false,
      "isRequired": false,
      "description": "Host where the back-end palinode-api process is reachable"
    },
    {
      "name": "PALINODE_API_PORT",
      "isSecret": false,
      "isRequired": false,
      "description": "Port for palinode-api"
    },
    {
      "name": "PALINODE_API_TOKEN",
      "isSecret": true,
      "isRequired": false,
      "description": "Optional bearer token enforced on every palinode-api request other than /health. Required when PALINODE_API_BIND_INTENT=public. Generate with: python -c 'import secrets; print(secrets.token_urlsafe(32))'."
    },
    {
      "name": "PALINODE_API_TOKEN_FILE",
      "isSecret": true,
      "isRequired": false,
      "description": "Path to a file containing the bearer token (alternative to PALINODE_API_TOKEN; for docker-secrets style deployments)"
    },
    {
      "name": "PALINODE_MCP_HTTP_HOST",
      "isSecret": false,
      "isRequired": false,
      "description": "Bind host for the MCP HTTP server. Defaults to loopback; set to 0.0.0.0 only with intentional network exposure (paired with PALINODE_API_BIND_INTENT=public on the back-end)."
    },
    {
      "name": "PALINODE_MCP_HTTP_PORT",
      "isSecret": false,
      "isRequired": false,
      "description": "Port for the MCP HTTP server"
    }
  ],
  "category": "files-docs",
  "subcategory": "formats",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/phasespace-labs/palinode"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "info",
      "detail": "Asks for 2 secrets: PALINODE_API_TOKEN, PALINODE_API_TOKEN_FILE"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account phasespace-labs"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "install-scripts",
      "label": "Install scripts",
      "result": "pass",
      "detail": "palinode 0.23.0 has no setup.py; nothing runs at install"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "pass",
      "detail": "Read 604 files in palinode 0.23.0: no obfuscation, encoded execution, credential reads or data-collection endpoints found"
    },
    {
      "id": "ai-text",
      "label": "Text aimed at the AI",
      "result": "warn",
      "detail": "Tells the AI to hide something from the user (palinode-0.23.0/palinode/core/agent_directed.py: \"… reveal|disclose|report … the user\", \"keep this hidden from the user\", \"without the user knowing\"; - cover…\"). Read the context: a security tool may quote these on purpose."
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [
    {
      "label": "Claude Desktop (pypi)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"palinode\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"palinode==0.23.0\"\n      ],\n      \"env\": {\n        \"PALINODE_DIR\": \"<your value>\"\n      }\n    }\n  }\n}"
    },
    {
      "label": "Claude Desktop (pypi)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"palinode\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"palinode==0.23.0\"\n      ],\n      \"env\": {\n        \"PALINODE_DIR\": \"<your value>\"\n      }\n    }\n  }\n}"
    }
  ],
  "curated": true,
  "stars": 46,
  "archived": false,
  "pushedAt": "2026-10-20T15:05:46Z",
  "health": {
    "score": 60,
    "parts": {
      "popularity": 0.37539229236174887,
      "activity": 0.6,
      "issues": 0.921875,
      "security": 0.8
    },
    "fail": 0,
    "warn": 1,
    "raw": {
      "stars": 46,
      "forks": 49,
      "downloads": 82,
      "hn": {
        "n": 0,
        "pts": 0,
        "t": []
      },
      "issuesOpen": 10,
      "issuesClosed": 118,
      "prsMerged": 100,
      "commits90": 0,
      "release": "2026-10-14T02:59:42Z",
      "pushed": "2026-10-20T15:05:46Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:35:52.424Z"
  }
}