{"id":21531944,"url":"https://github.com/matrixai/polykey-cli","last_synced_at":"2026-03-15T23:01:54.605Z","repository":{"id":151338796,"uuid":"438439908","full_name":"MatrixAI/Polykey-CLI","owner":"MatrixAI","description":"Polykey CLI - Open Source Decentralized Secret Sharing System for Zero Trust Workflows","archived":false,"fork":false,"pushed_at":"2024-05-23T03:36:42.000Z","size":2436,"stargazers_count":5,"open_issues_count":48,"forks_count":2,"subscribers_count":5,"default_branch":"staging","last_synced_at":"2024-05-23T04:54:03.896Z","etag":null,"topics":["authentication","authorization","cli","git","keys","passwords","secrets"],"latest_commit_sha":null,"homepage":"https://polykey.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MatrixAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2021-12-15T00:09:56.000Z","updated_at":"2024-05-29T10:04:06.374Z","dependencies_parsed_at":null,"dependency_job_id":"888c0f97-3db0-47a1-8deb-8df3e5670ec2","html_url":"https://github.com/MatrixAI/Polykey-CLI","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixAI%2FPolykey-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixAI%2FPolykey-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixAI%2FPolykey-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixAI%2FPolykey-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MatrixAI","download_url":"https://codeload.github.com/MatrixAI/Polykey-CLI/tar.gz/refs/heads/staging","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248133964,"owners_count":21053362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["authentication","authorization","cli","git","keys","passwords","secrets"],"created_at":"2024-11-24T02:18:15.485Z","updated_at":"2026-03-15T23:01:54.594Z","avatar_url":"https://github.com/MatrixAI.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://polykey.com/images/polykey-logotype-light-light.svg\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://polykey.com/images/polykey-logotype-dark-dark.svg\"\u003e\n    \u003cimg width=\"512\" alt=\"Polykey Logo\" src=\"https://polykey.com/images/polykey-logotype-light-light.svg\"\u003e\n  \u003c/picture\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/tag/MatrixAI/Polykey-CLI?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/MatrixAI/Polykey-CLI/release.yml?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/d18m/polykey-cli?style=for-the-badge\u0026label=npm%20downloads\u0026color=d02b1d\"\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/MatrixAI/Polykey-CLI/total?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/MatrixAI/Polykey-CLI?style=for-the-badge\"\u003e\n\u003c/div\u003e\n\n## What is Polykey?\n\n**Polykey is an open-source, peer-to-peer system** that addresses the critical\nchallenge in cybersecurity: **the secure sharing and delegation of authority**,\nin the form of secrets like keys, tokens, certificates, and passwords.\n\nIt allows users including developers, organizations, and machines—to **store\nthese secrets in encrypted vaults on their own devices, and share them directly\nwith trusted parties.**\n\n- **All data is end-to-end encrypted**, both in transit and at rest, eliminating\n  the risk associated with third-party storage.\n- **Polykey provides a command line interface**, desktop and mobile GUI, and a\n  web-based control plane for organizational management.\n- By treating secrets as tokenized authority, it offers a fresh approach to\n  **managing and delegating authority in zero-trust architectures** without\n  adding burdensome policy complexity - a pervasive issue in existing zero-trust\n  systems.\n- Unlike complex self-hosted secrets management systems that require specialized\n  skills and infrastructure, Polykey is **installed and running directly from\n  the end-user device**.\n- It is built to **automatically navigate network complexities** like NAT\n  traversal, connecting securely to other nodes without manual configuration.\n\n**Key features:**\n\n- **Decentralized Encrypted Storage** - No storage of secrets on third parties,\n  secrets are stored on your device and synchronised point-to-point between\n  Polykey nodes.\n- **Secure Peer-to-Peer Communication** - Polykey bootstraps TLS keys by\n  federating trusted social identities (e.g. GitHub).\n- **Secure Computational Workflows** - Share static secrets (passwords, keys,\n  tokens and certificates) with people, between teams, and across machine\n  infrastructure. Create dynamic (short-lived) smart-tokens with embedded policy\n  for more sophisticated zero-trust authority verification.\n- With Polykey Enterprise, you can create private networks of Polykey nodes and\n  apply mandatory policy governing node behaviour.\n\n## Table of Contents\n\n- [Installation](#installation)\n  - [Nix](#nix)\n  - [Docker](#docker)\n- [Development](#development)\n  - [Calling Commands](#calling-commands)\n  - [Docs Generation](#docs-generation)\n  - [Publishing](#publishing)\n- [License](#license)\n\n## Installation\n\nNote that JavaScript libraries are not packaged in Nix. Only JavaScript\napplications are.\n\nBuilding the package:\n\n```sh\nnix build\n```\n\n### Nix\n\n```sh\nnix build\nnix build '.#executable'\nnix build '.#docker'\nnix build '.#packages.x86_64-linux.executable'\nnix build '.#packages.x86_64-windows.executable'\nnix build '.#packages.x86_64-darwin.executable'\n```\n\nInstall into Nix user profile:\n\n```sh\nnix profile install github:MatrixAI/Polykey-CLI\n```\n\nThe program can be run directly without installing via `nix run`\n\n```sh\nnix run . -- agent start\n```\n\n### Docker\n\nInstall into Docker:\n\n```sh\nnix build '.#docker'\nimage=\"$(docker load \u003c result | cut -d' ' -f3)\"\ndocker run -it \"$image\"\n```\n\n## Development\n\nRun `nix develop`, and once you're inside, you can use:\n\n```sh\n# install (or reinstall packages from package.json)\nnpm install\n# build the dist\nnpm run build\n# run the repl (this allows you to import from ./src)\nnpm run tsx\n# run the tests\nnpm run test\n# lint the source code\nnpm run lint\n# automatically fix the source\nnpm run lintfix\n```\n\n### Calling Commands\n\nWhen calling commands in development, use this style:\n\n```sh\nnpm run polykey -- p1 p2 p3\n```\n\nThe `--` is necessary to make `npm` understand that the parameters are for your\nown executable, and not parameters to `npm`.\n\n### Docs Generation\n\n```sh\nnpm run docs\n```\n\nSee the docs at: https://matrixai.github.io/Polykey-CLI/\n\n### Publishing\n\n```sh\n# npm login\nnpm version patch # major/minor/patch\nnpm run build\nnpm publish --access public\ngit push\ngit push --tags\n```\n\n## License\n\nPolykey-CLI is licensed under the GPLv3, you may read the terms of the license\n[here](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixai%2Fpolykey-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatrixai%2Fpolykey-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixai%2Fpolykey-cli/lists"}