{"id":36679018,"url":"https://github.com/centy-io/centy-daemon","last_synced_at":"2026-04-01T23:06:00.735Z","repository":{"id":327281872,"uuid":"1108666090","full_name":"centy-io/centy-daemon","owner":"centy-io","description":"File-based storage and query engine — persists structured data as Markdown files with YAML frontmatter, exposed via gRPC","archived":false,"fork":false,"pushed_at":"2026-03-25T15:28:20.000Z","size":3672,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-25T22:51:39.066Z","etag":null,"topics":["centy","file-based","grpc","local-first","markdown","project-management","rust"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/centy-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"Roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-02T18:50:22.000Z","updated_at":"2026-03-25T15:29:36.000Z","dependencies_parsed_at":"2026-02-10T12:06:10.263Z","dependency_job_id":null,"html_url":"https://github.com/centy-io/centy-daemon","commit_stats":null,"previous_names":["tupe12334/centy-daemon"],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/centy-io/centy-daemon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centy-io%2Fcenty-daemon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centy-io%2Fcenty-daemon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centy-io%2Fcenty-daemon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centy-io%2Fcenty-daemon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/centy-io","download_url":"https://codeload.github.com/centy-io/centy-daemon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centy-io%2Fcenty-daemon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["centy","file-based","grpc","local-first","markdown","project-management","rust"],"created_at":"2026-01-12T10:53:36.263Z","updated_at":"2026-04-01T23:06:00.714Z","avatar_url":"https://github.com/centy-io.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# centy-daemon\n\nA file-based database engine that stores structured data as Markdown files with YAML frontmatter, exposed via gRPC.\n\n## What is centy-daemon?\n\ncenty-daemon is the **storage and query engine** behind [Centy](https://centy.io). It persists all data directly to the filesystem — no external database required. Every record is a human-readable Markdown file with structured metadata in YAML frontmatter, stored inside a `.centy` directory that can be version-controlled with git.\n\nThe daemon runs as a local gRPC service and provides:\n\n- **File-based persistence** — all data lives as `.md` files on disk\n- **Structured metadata** — YAML frontmatter for typed fields (status, priority, timestamps, custom fields)\n- **CRUD operations** — create, read, update, delete for all entity types\n- **Query engine** — advanced search with a custom query language (boolean logic, field operators, wildcards, regex)\n- **File integrity** — SHA-256 hashing and reconciliation for managed files\n- **Entity linking** — bidirectional relationships between records\n- **Multi-project support** — a registry that tracks multiple databases across the filesystem\n- **Organization grouping** — sync records across projects within an organization\n\nThis entire directory is designed to be committed to git, making the database portable, diffable, and mergeable.\n\n## Installation\n\n```bash\ngit clone https://github.com/centy-io/centy-daemon.git\ncd centy-daemon\ncargo build --release\n```\n\n## Usage\n\n### Start the daemon\n\n```bash\n# Default: binds to 127.0.0.1:50051\ncenty-daemon\n\n# Custom address\ncenty-daemon --addr 127.0.0.1:50052\n\n# Allow additional CORS origins\ncenty-daemon --cors-origins=http://localhost:5180\n\n# Using environment variables\nCENTY_DAEMON_ADDR=127.0.0.1:50052 centy-daemon\n```\n\n### gRPC API\n\nThe daemon supports both **native gRPC** (HTTP/2) and **gRPC-Web** (HTTP/1.1), making it compatible with:\n\n- Native gRPC clients (CLI tools, backend services)\n- Browser-based applications (via gRPC-Web/Connect)\n\n#### Core Operations\n\nSee [`proto/centy.proto`](proto/centy.proto) for the full API specification (70+ RPCs).\n\n### CORS Configuration\n\nThe daemon always allows CORS requests from:\n\n- All `*.centy.io` subdomains (e.g., `https://app.centy.io`)\n- Localhost origins (`http://localhost`, `https://localhost`, `http://127.0.0.1`, `https://127.0.0.1`)\n\nTo allow additional custom origins:\n\n```bash\ncenty-daemon --cors-origins=http://localhost:5180,https://myapp.example.com\n```\n\n### Testing the API\n\n```bash\n# Install grpcui for a web-based API explorer\ngo install github.com/fullstorydev/grpcui/cmd/grpcui@latest\ngrpcui -plaintext 127.0.0.1:50051\n\n# Or use grpcurl for CLI-based interaction\ngrpcurl -plaintext 127.0.0.1:50051 list\ngrpcurl -plaintext -d '{\"project_path\": \"/path/to/project\"}' \\\n  127.0.0.1:50051 centy.CentyDaemon/IsInitialized\n```\n\n## E2E Tests\n\n```bash\ncd e2e\npnpm install\npnpm daemon:build\npnpm daemon:start   # in another terminal\npnpm test\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and contribution guidelines.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcenty-io%2Fcenty-daemon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcenty-io%2Fcenty-daemon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcenty-io%2Fcenty-daemon/lists"}