{"id":49504015,"url":"https://github.com/edlontech/gingko-mem","last_synced_at":"2026-05-01T13:33:20.488Z","repository":{"id":353519485,"uuid":"1219776442","full_name":"edlontech/gingko-mem","owner":"edlontech","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-24T09:23:50.000Z","size":603,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T09:45:36.307Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edlontech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-24T07:53:26.000Z","updated_at":"2026-04-24T09:23:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/edlontech/gingko-mem","commit_stats":null,"previous_names":["edlontech/gingko-mem"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/edlontech/gingko-mem","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edlontech%2Fgingko-mem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edlontech%2Fgingko-mem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edlontech%2Fgingko-mem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edlontech%2Fgingko-mem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edlontech","download_url":"https://codeload.github.com/edlontech/gingko-mem/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edlontech%2Fgingko-mem/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32499683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-01T13:33:19.649Z","updated_at":"2026-05-01T13:33:20.456Z","avatar_url":"https://github.com/edlontech.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"logo.png\" alt=\"Gingko\" width=\"256\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eGingko\u003c/h1\u003e\n\nGingko is a application that exposes a project-scoped memory graph\nover [MCP](https://modelcontextprotocol.io). Any agent that speaks MCP can\nopen a project, record observations, recall past memories, and navigate the\nknowledge graph that builds up across sessions.\n\nUnder the hood it uses [Mnemosyne](https://github.com/edlontech/mnemosyne) as a memory engine\n\n## Development Quick start\n\nFor development, if you have mise, just run:\n\n```bash\nmix setup         # fetch deps, install assets\nmix phx.server\n```\n\nThen point an MCP client at `http://localhost:8008/mcp`. The first time the\nserver boots it creates `~/.gingko/` with a default config and guides you\nthrough setup at `http://localhost:8008/setup` if anything is missing.\n\n## Documentation\n\nLong-form guides live in [`guides/`](guides/README.md):\n\n- [Getting Started](guides/getting-started.md)\n- [Memory Model](guides/memory-model.md) — projects, sessions, steps, node types\n- [MCP Tools Reference](guides/mcp-tools.md)\n- [Configuration](guides/configuration.md) — every knob in `config.toml`\n- [Extraction Profiles](guides/extraction-profiles.md) — per-domain and per-project overlays\n- [Summaries \u0026 Session Primer](guides/summaries-and-primer.md) — charter, state, clusters\n- [Maintenance \u0026 Tuning](guides/maintenance-and-tuning.md) — decay, consolidate, validate, value function\n- [Deployment](guides/deployment.md) — releases and Burrito binaries\n\n## MCP tool surface\n\nWrite flow:\n\n- `open_project_memory` → `start_session` → `append_step` → (auto-commit on\n  session end; `close_async` or `commit_session` for explicit flushes)\n\nRead flow:\n\n- `recall`, `get_node`, `get_session_state`, `list_projects`, `latest_memories`\n\nSummary layer (opt-out via `[summaries].enabled`):\n\n- `get_session_primer`, `get_cluster`, `set_charter`, `refresh_principal_memory`\n\nGraph maintenance:\n\n- `run_maintenance` with `decay`, `consolidate`, or `validate`\n\nSee [MCP Tools](guides/mcp-tools.md) for the full reference.\n\n## Runtime layout\n\nAll state lives under `$GINGKO_HOME` (default `~/.gingko`):\n\n```\n~/.gingko/\n├── config.toml          # runtime configuration\n├── memory/              # Mnemosyne DETS graph files, one subdir per project\n└── metadata.sqlite3     # projects, sessions, summaries\n```\n\nAPI keys are never written to `config.toml` — only the env-var names to read.\nExport `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or whichever provider keys your\nconfigured providers need.\n\n## Local development\n\nAsset toolchain requirement: Yarn 1.x, or Node with Corepack enabled.\n`mix setup` auto-detects `yarn`, then `corepack yarn`, and exits with a clear\nmessage if neither is available.\n\n```bash\nmix setup\nmix phx.server          # http://localhost:8008\n```\n\nThe web UI has three main views:\n\n- `/` — project grid with live stats.\n- `/setup` — edit `config.toml` from the browser.\n- `/projects` — real-time graph monitor backed by Cytoscape.\n\n## Testing\n\n```bash\nmix test                 # full suite\nmix precommit            # warnings-as-errors + deps.unlock --unused + format + test\n```\n\nIntegration coverage for the MCP tools lives in\n`test/gingko/mcp/write_flow_test.exs` and `test/gingko/mcp/read_flow_test.exs`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedlontech%2Fgingko-mem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedlontech%2Fgingko-mem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedlontech%2Fgingko-mem/lists"}