{"id":50089470,"url":"https://github.com/iodesystems/zdx","last_synced_at":"2026-05-22T22:07:50.919Z","repository":{"id":357468860,"uuid":"1204054746","full_name":"IodeSystems/zdx","owner":"IodeSystems","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-12T22:07:07.000Z","size":5954,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-13T00:11:50.693Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IodeSystems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07T16:41:00.000Z","updated_at":"2026-05-12T22:07:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/IodeSystems/zdx","commit_stats":null,"previous_names":["iodesystems/zdx"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/IodeSystems/zdx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IodeSystems%2Fzdx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IodeSystems%2Fzdx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IodeSystems%2Fzdx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IodeSystems%2Fzdx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IodeSystems","download_url":"https://codeload.github.com/IodeSystems/zdx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IodeSystems%2Fzdx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33372739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-22T21:56:13.512Z","status":"ssl_error","status_checked_at":"2026-05-22T21:56:10.769Z","response_time":265,"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":[],"created_at":"2026-05-22T22:07:49.171Z","updated_at":"2026-05-22T22:07:50.913Z","avatar_url":"https://github.com/IodeSystems.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zdx\n\nA self-hosted developer-experience platform for human+LLM collaborative software development. Track issues, features, themes, and goals; manage work queues; ingest observability data (timings, errors, logs, counters); and ship with confidence — all from a single portal and CLI.\n\n**Live instance:** https://zdx.iodesystems.com\n\n## Architecture\n\n| Layer | Tech | Location |\n|-------|------|----------|\n| API server | Go, huma/chi, pgx | `cmd/dx-server/`, `internal/server/` |\n| CLI | Go, cobra | `cmd/dx/`, `internal/cli/` |\n| UI | React 19, Vite, MUI, TanStack Router | `ui/` |\n| Database | PostgreSQL, sqlc | `queries/`, `internal/db/`, `internal/migrate/sql/` |\n| Vector search | pgvector via zvec | `internal/zvec/` |\n| Realtime | WebSockets + Valkey | `internal/ws/` |\n\n## Prerequisites\n\n- Go 1.25+\n- Node.js 20+ / npm\n- PostgreSQL 16+ with pgvector\n- sqlc (`go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest`)\n\n## Quickstart\n\n```bash\n# Clone and build\ngit clone https://github.com/iodesystems/zdx-go.git\ncd zdx-go\nmake build        # compiles dx, dx-server, db binaries\nmake ui           # builds the React frontend\n\n# Database\nexport DATABASE_URL=\"postgres://user:pass@localhost:5432/zdx?sslmode=disable\"\n./bin/db migrate   # run migrations\n\n# Run\n./bin/dev          # starts server with auto-migrate + UI dev server\n```\n\nThe server listens on `:7600` by default.\n\n## Key commands\n\n```bash\n./bin/dx todo take           # claim the next work item\n./bin/dx issue add           # file an issue\n./bin/dx feature list        # list features\n./bin/dx goal list           # list project goals\n./bin/dx theme list          # list roadmap themes\nmake test                    # run all tests\n./bin/ship                   # build, test, deploy\n```\n\n## Directory layout\n\n```\ncmd/\n  dx-server/       API server entry point\n  dx/              CLI entry point\n  db/              Database migration tool\ninternal/\n  cli/             Cobra command tree\n  config/          Configuration loading\n  db/              sqlc-generated database layer\n  llm/             LLM integration\n  migrate/         Migration runner\n  server/          HTTP handlers and middleware\n  testharness/     Unified test adapter framework\n  ws/              WebSocket realtime events\n  zvec/            Vector similarity search\nui/                React frontend (Vite + MUI)\nqueries/           SQL query files (sqlc input)\ninternal/migrate/sql/  Database migration SQL files (up/down pairs)\ndeploy/            Deployment artifacts and provisioning\ninfra/             Infrastructure and provisioning clients\n```\n\n## License\n\nProprietary — IODesystems.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiodesystems%2Fzdx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiodesystems%2Fzdx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiodesystems%2Fzdx/lists"}