markramm

markramm/pyrite

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

25 good first / help-wanted issues · Python · last activity Sep 18, 2026

5 stars 1 forks 5 watchers Python MIT License
ai-agents cli git knowledge-as-code knowledge-base knowledge-management markdown mcp pkm second-brain semantic-search
View on GitHub
25 Open Issues Need Help Last updated: Sep 18, 2026

Open Issues Need Help

View All on GitHub
`pyrite search/get/list --fields` returns rows with no `id` or `kb_name` about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
QUERY_SYNTAX error leads with raw SQLite ('no such column: party') — name the offending token instead about 1 month ago
enhancement good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
index health: subdirectory_mismatches false-positives on every entry (trailing slash not stripped) about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
CHANGELOG.md conflicted five times in one session, three of them on first-time contributors' PRs about 1 month ago
good first issue process quality
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
pyrite create -t note silently creates an ADR (adr_number: 0) instead of a note or an error about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
Pyrite never configures logging — `logger.warning` falls through to Python's last-resort handler about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
pyrite sw backlog returns 214 KB unpaginated, and CLAUDE.md recommends it as a "quick context lookup" about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
Agent-facing docs state four things that are false: a flag that doesn't exist, has_more on surfaces that lack it, tool counts off by 2.4x, and a tier default that differs per binary about 1 month ago
bug good first issue docs
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
The dev-environment runbook gives a setup that cannot run the suite, and CONTRIBUTING links to it for troubleshooting about 1 month ago
bug good first issue docs
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
Railway one-click deploy likely fails: bind host and port are never set about 1 month ago
bug good first issue deploy
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_bulk_create is not best-effort: one malformed entry rejects the whole batch about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
cascade_network has no limit/offset — unbounded on hub nodes (~18k tokens for thiel-peter) about 1 month ago
bug good first issue extensions
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
index sync skips a file moved into a path the index already knows if its mtime predates indexed_at about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
?fields= is broken on GET /api/entries/{id} (500) and GET /api/search (400 with a raw validation dump) about 1 month ago
bug good first issue
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_batch_read follow-up to #126: unguarded entry_id in the spec loop, CHANGELOG line, and the identity-pair promise is wider than the behaviour about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_manage(add_type) silently overwrites an existing type definition about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_batch_read / kb_get: an explicit body_limit is silently overridden by fields — asking for less returns 28× more about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
REST POST /entries/batch: unguarded entry_id, no identity pair in projection, found/not_found contradict each other with fields — parity with the #126 MCP fix about 1 month ago
bug good first issue server
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_link validates the source entry but not the target — silently creates dangling links (mechanism behind #64) about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb_batch_read: raw KeyError 'kb_name' when fields omits kb_name; retryable is wrongly true about 1 month ago
bug good first issue mcp
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
db backup writes into the current directory; default to the data directory about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
index health: exit non-zero when unhealthy, and accept -k to scope to one KB about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
sw new-adr does not slugify punctuation in filenames; created files end with a blank line about 1 month ago
bug good first issue cli extensions
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
Entry ids from non-ASCII or very long titles: empty id, mangled slug, or OSError about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search
kb remove permanently refuses a KB whose config.yaml entry was already deleted about 1 month ago
bug good first issue cli
markramm/pyrite
5

A second brain for you, your agents, and your teams. Knowledge-as-Code: markdown + YAML in git, schema-validated, with semantic search and a three-tier MCP server. CLI, REST API, web UI, and plugin system. Zero running cost locally.

Python
#ai-agents#cli#git#knowledge-as-code#knowledge-base#knowledge-management#markdown#mcp#pkm#second-brain#semantic-search