{"id":13521141,"url":"https://github.com/authzed/zed","last_synced_at":"2026-04-02T14:28:57.202Z","repository":{"id":39285790,"uuid":"357107303","full_name":"authzed/zed","owner":"authzed","description":"Official command-line tool for managing SpiceDB","archived":false,"fork":false,"pushed_at":"2026-03-27T20:46:34.000Z","size":2191,"stargazers_count":151,"open_issues_count":50,"forks_count":38,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-28T01:27:18.653Z","etag":null,"topics":["authorization","authzed","authzed-client","command-line-tool","database-management","fine-grained-access-control","fine-grained-authorization","go","golang","permissions","production","sdk","security","security-tools","spicedb","spicedb-client","zanzibar"],"latest_commit_sha":null,"homepage":"https://authzed.com/docs/reference/clients","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/authzed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":"DCO","cla":null}},"created_at":"2021-04-12T08:00:41.000Z","updated_at":"2026-03-27T20:46:39.000Z","dependencies_parsed_at":"2024-11-02T05:31:34.760Z","dependency_job_id":"4a26d981-9337-4603-8519-35f86e27d8d5","html_url":"https://github.com/authzed/zed","commit_stats":null,"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"purl":"pkg:github/authzed/zed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/authzed%2Fzed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/authzed%2Fzed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/authzed%2Fzed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/authzed%2Fzed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/authzed","download_url":"https://codeload.github.com/authzed/zed/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/authzed%2Fzed/sbom","scorecard":{"id":217132,"data":{"date":"2025-08-11","repo":{"name":"github.com/authzed/zed","commit":"a2cb94fdfd2db9106bc101d442e090796e4cc1f8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":6,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":8,"reason":"10 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 8","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/lint.yaml:40","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/lint.yaml:41","Info: jobLevel 'actions' permission set to 'read': .github/workflows/lint.yaml:39","Warn: no topLevel permission defined: .github/workflows/build-test.yaml:1","Warn: no topLevel permission defined: .github/workflows/cla.yaml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/docs.yaml:14","Warn: topLevel 'actions' permission set to 'write': .github/workflows/docs.yaml:16","Warn: no topLevel permission defined: .github/workflows/lint.yaml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release-windows.yml:8","Warn: topLevel 'packages' permission set to 'write': .github/workflows/release-windows.yml:9","Warn: no topLevel permission defined: .github/workflows/release.yaml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-test.yaml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-test.yaml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-test.yaml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-test.yaml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-test.yaml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/build-test.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/cla.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/cla.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yaml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/docs.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs.yaml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/docs.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs.yaml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/docs.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yaml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/docs.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs.yaml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/docs.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yaml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yaml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yaml:71: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yaml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yaml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yaml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/lint.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-windows.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release-windows.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-windows.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release-windows.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-windows.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release-windows.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-windows.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release-windows.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-windows.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release-windows.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yaml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yaml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yaml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yaml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yaml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/authzed/zed/release.yaml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:5","Warn: containerImage not pinned by hash: Dockerfile:10: pin your Docker image by updating cgr.dev/chainguard/glibc-dynamic:latest to cgr.dev/chainguard/glibc-dynamic:latest@sha256:f280bd47fd58f5d00246a2c4412350540e8915c82127949471fff1172ebd302c","Warn: containerImage not pinned by hash: Dockerfile.release:8","Warn: goCommand not pinned by hash: .github/workflows/build-test.yaml:54","Info:   0 out of  14 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  31 third-party GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned","Info:   0 out of   1 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.30.2 not signed: https://api.github.com/repos/authzed/zed/releases/215519840","Warn: release artifact v0.30.1 not signed: https://api.github.com/repos/authzed/zed/releases/214827777","Warn: release artifact v0.30.0 not signed: https://api.github.com/repos/authzed/zed/releases/214639992","Warn: release artifact v0.29.0 not signed: https://api.github.com/repos/authzed/zed/releases/214591143","Warn: release artifact v0.28.0 not signed: https://api.github.com/repos/authzed/zed/releases/214275632","Warn: release artifact v0.30.2 does not have provenance: https://api.github.com/repos/authzed/zed/releases/215519840","Warn: release artifact v0.30.1 does not have provenance: https://api.github.com/repos/authzed/zed/releases/214827777","Warn: release artifact v0.30.0 does not have provenance: https://api.github.com/repos/authzed/zed/releases/214639992","Warn: release artifact v0.29.0 does not have provenance: https://api.github.com/repos/authzed/zed/releases/214591143","Warn: release artifact v0.28.0 does not have provenance: https://api.github.com/repos/authzed/zed/releases/214275632"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/lint.yaml:67"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: all commits (30) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T01:51:59.626Z","repository_id":39285790,"created_at":"2025-08-17T01:51:59.626Z","updated_at":"2025-08-17T01:51:59.626Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308094,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["authorization","authzed","authzed-client","command-line-tool","database-management","fine-grained-access-control","fine-grained-authorization","go","golang","permissions","production","sdk","security","security-tools","spicedb","spicedb-client","zanzibar"],"created_at":"2024-08-01T06:00:29.238Z","updated_at":"2026-04-02T14:28:57.195Z","avatar_url":"https://github.com/authzed.png","language":"Go","funding_links":[],"categories":["Developer Tools","Go"],"sub_categories":["Official Tools"],"readme":"# zed\n\n[![Docs](https://img.shields.io/badge/docs-authzed.com-%234B4B6C \"Authzed Documentation\")](https://authzed.com/docs)\n[![YouTube](https://img.shields.io/youtube/channel/views/UCFeSgZf0rPqQteiTQNGgTPg?color=%23F40203\u0026logo=youtube\u0026style=flat-square\u0026label=YouTube \"Authzed YouTube Channel\")](https://www.youtube.com/channel/UCFeSgZf0rPqQteiTQNGgTPg)\n[![Discord Server](https://img.shields.io/discord/844600078504951838?color=7289da\u0026logo=discord \"Discord Server\")](https://authzed.com/discord)\n[![Twitter](https://img.shields.io/badge/twitter-%40authzed-1D8EEE?logo=twitter \"@authzed on Twitter\")](https://twitter.com/authzed)\n[![Docker Pulls](https://img.shields.io/docker/pulls/authzed/zed?color=%23448CE6\u0026style=flat-square)](https://hub.docker.com/r/authzed/zed/tags)\n[![Codecov](https://img.shields.io/codecov/c/github/authzed/zed)](https://app.codecov.io/gh/authzed/zed)\n\nA command-line client for managing [SpiceDB].\n\n[SpiceDB]: https://github.com/authzed/spicedb\n\nzed features include:\n\n- Context switching that stores credentials securely in your OS keychain\n- Check, Expand, Lookup Resources, Lookup Subjects commands for Permissions\n- Create, Read, Watch, Touch, Delete, Bulk-Delete commands for Relationships\n- Read, Write, Validate, Import, Copy and Compile commands for Schemas\n- Backup and Restore commands\n\nHave questions? Ask in our [Discord].\n\nLooking to contribute? See [CONTRIBUTING.md].\n\nYou can find issues by priority: [Urgent], [High], [Medium], [Low], [Maybe].\nThere are also [good first issues].\n\n[Discord]: https://authzed.com/discord\n[CONTRIBUTING.md]: https://github.com/authzed/spicedb/blob/main/CONTRIBUTING.md\n[Urgent]: https://github.com/authzed/spicedb/labels/priority%2F0%20urgent\n[High]: https://github.com/authzed/spicedb/labels/priority%2F1%20high\n[Medium]: https://github.com/authzed/spicedb/labels/priority%2F2%20medium\n[Low]: https://github.com/authzed/spicedb/labels/priority%2F3%20low\n[Maybe]: https://github.com/authzed/spicedb/labels/priority%2F4%20maybe\n[good first issues]: https://github.com/authzed/spicedb/labels/hint%2Fgood%20first%20issue\n\n## Getting Started\n\n### Installing the binary\n\nBinary releases are available for Linux, macOS, and Windows on AMD64 and ARM64 architectures.\n\n[Homebrew] users for both macOS and Linux can install the latest binary releases of zed using the official tap:\n\n```sh\nbrew install authzed/tap/zed\n```\n\n[Debian-based Linux] users can install zed packages by adding a new APT source:\n\nFirst, download the public signing key for the repository:\n\n```sh\n# In releases older than Debian 12 and Ubuntu 22.04, the folder `/etc/apt/keyrings` does not exist by default, and it should be created before the curl command.\n# sudo mkdir -p -m 755 /etc/apt/keyrings\n\ncurl -sS https://pkg.authzed.com/apt/gpg.key | sudo gpg --dearmor --yes -o /etc/apt/keyrings/authzed.gpg\n```\n\nThen add the list file for the repository:\n\n```sh\necho \"deb [signed-by=/etc/apt/keyrings/authzed.gpg] https://pkg.authzed.com/apt/ * *\"  | sudo tee /etc/apt/sources.list.d/authzed.list\nsudo chmod 644 /etc/apt/sources.list.d/authzed.list  # helps tools such as command-not-found to work correctly\n\n```\n\nAlternatively, if you want to use the new `deb822`-style `authzed.sources` format, put the following in `/etc/apt/sources.list.d/authzed.sources`:\n\n```yaml\nTypes: deb\nURIs: https://pkg.authzed.com/apt/\nSuites: *\nComponents: *\nSigned-By: /etc/apt/keyrings/authzed.gpg\n```\n\nOnce you've defined the sources and updated your apt cache, it can be installed just like any other package:\n\n```sh\nsudo apt update\nsudo apt install -y zed\n```\n\n[RPM-based Linux] users can install zed packages by adding a new YUM repository:\n\n```sh\nsudo cat \u003c\u003c EOF | sudo tee /etc/yum.repos.d/Authzed-Fury.repo\n[authzed-fury]\nname=AuthZed Fury Repository\nbaseurl=https://yum.fury.io/authzed/\nenabled=1\ngpgcheck=0\nEOF\nsudo dnf install -y zed\n```\n\n[homebrew]: https://docs.authzed.com/spicedb/installing#brew\n[Debian-based Linux]: https://en.wikipedia.org/wiki/List_of_Linux_distributions#Debian-based\n[RPM-based Linux]: https://en.wikipedia.org/wiki/List_of_Linux_distributions#RPM-based\n\n### Other methods\n\n#### Docker\n\nContainer images are available for AMD64 and ARM64 architectures on the following registries:\n\n- [authzed/zed](https://hub.docker.com/r/authzed/zed)\n- [ghcr.io/authzed/zed](https://github.com/authzed/zed/pkgs/container/zed)\n- [quay.io/authzed/zed](https://quay.io/authzed/zed)\n\nYou can pull down the latest stable release:\n\n```sh\ndocker pull authzed/zed\n```\n\nAfterward, you can run it with `docker run`:\n\n```sh\ndocker run --rm authzed/zed version\n```\n\n### Build from Source\n\n```sh\ngit clone git@github.com:authzed/zed.git\ncd zed\ngo build ./cmd/zed\n```\n\n### Creating a context\n\nContexts store connection credentials for accessing SpiceDB clusters securely in the OS keychain.\nBefore performing most commands, a context must be set.\n\nThe `zed context` subcommand has operations for setting the current, creating, listing, deleting contexts:\n\n```sh\nzed context set prod grpc.authzed.com:443 tc_zed_my_laptop_deadbeefdeadbeefdeadbeefdeadbeef\nzed context set dev localhost:80 testpresharedkey --insecure\nzed context list\n```\n\n### Overriding Context\n\nYou can also provide context values via environment variables or CLI flags. If values are provided this way, they override\nthe context values in a piecemeal fashion:\n\n```sh\nzed context set prod grpc.authzed.com:443 tc_zed_my_laptop_deadbeefdeadbeefdeadbeefdeadbeef\n\n# This will use the token and TLS values set above, but swap out the endpoint for the one provided.\nzed permission check --endpoint my.authzed.domain:443 document:firstdoc writer user:emilia\n```\n\n### Headless usage\n\nIf you provide all context values (e.g. `ZED_ENDPOINT`, `ZED_TOKEN`) as environment variables or flags (e.g. `--endpoint`, `--token`), you do not need to set a context.\nYou can also provide the `ZED_KEYRING_PASSWORD` environment variable to access an existing context in a non-interactive way.\n\n```sh\nzed schema read --endpoint grpc.authzed.com:443 --token tc_zed_my_laptop_deadbeefdeadbeef\nZED_ENDPOINT=grpc.authzed.com:443 ZED_TOKEN=tc_zed_my_laptop_deadbeefdeadbeef zed schema read\nZED_KEYRING_PASSWORD=redacted zed schema read\n```\n\n### Debugging\n\nThe `--explain` flag can be used on `permission check` to see a trace:\n\n```sh\nzed permission check document:firstdoc writer user:emilia --explain\n```\n\n## FAQ\n\n### `commands` vs `cmd`\n\n`zed` is used both via WASM in the playground and as a CLI. The commands in `commands` are\nthe commands that zed uses in the playground to talk to the WASM instance of SpiceDB.\nThe commands in `cmd` are those which are CLI-only.\n\n## Acknowledgements\n\nzed is a community project fueled by contributions from both organizations and individuals.\nWe appreciate all contributions, large and small, and would like to thank all those involved.\n\nIn addition, we'd like to highlight a few notable contributions:\n\n- The GitHub Authorization Team for implementing the bulk-delete command\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauthzed%2Fzed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fauthzed%2Fzed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauthzed%2Fzed/lists"}