{"id":28709782,"url":"https://github.com/permify/targe","last_synced_at":"2025-06-14T20:40:20.286Z","repository":{"id":269796937,"uuid":"897754082","full_name":"Permify/targe","owner":"Permify","description":"Open-source CLI for managing IAM (Identity and Access Management) operations with AI assistance.","archived":false,"fork":false,"pushed_at":"2025-03-24T08:17:03.000Z","size":88283,"stargazers_count":30,"open_issues_count":7,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T09:25:08.713Z","etag":null,"topics":["authorization","aws","awscli","azure","cloud","gcp","iam","security"],"latest_commit_sha":null,"homepage":"https://permify.co","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/Permify.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-03T07:18:14.000Z","updated_at":"2025-03-24T08:12:41.000Z","dependencies_parsed_at":"2025-03-24T09:23:07.196Z","dependency_job_id":"42bfbcdf-a810-4a2f-88f8-c2d5295b9a71","html_url":"https://github.com/Permify/targe","commit_stats":null,"previous_names":["permify/kivo","permify/targe"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/Permify/targe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Permify%2Ftarge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Permify%2Ftarge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Permify%2Ftarge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Permify%2Ftarge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Permify","download_url":"https://codeload.github.com/Permify/targe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Permify%2Ftarge/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259881035,"owners_count":22926061,"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":["authorization","aws","awscli","azure","cloud","gcp","iam","security"],"created_at":"2025-06-14T20:39:50.618Z","updated_at":"2025-06-14T20:40:20.266Z","avatar_url":"https://github.com/Permify.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/Permify/targe/raw/master/assets/images/logo-targe-dark.png\"\u003e\n    \u003cimg alt=\"Targe logo\" src=\"https://github.com/Permify/targe/raw/master/assets/images/logo-targe-light.png\" width=\"40%\"\u003e\n  \u003c/picture\u003e\n\u003ch1 align=\"center\"\u003e\n   Targe - Open Source IAM Copilot\n\u003c/h1\u003e\n\u003c/div\u003e\n\u003cp\u003e\nTarge is an open-source CLI for managing IAM (Identity and Access Management) operations with AI assistance.\n\nDevOps engineers use Targe to configure how employees in their organization access infrastructure resources. Targe simplifies and accelerates granting and revoking access, while supporting custom policy creation — eliminating the need for tedious back-and-forth UI work.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/Permify/targe\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/Permify/targe?style=for-the-badge\u0026logo=go\" alt=\"Permify Go Version\" /\u003e\u003c/a\u003e\u0026nbsp;\n \u003ca href=\"https://goreportcard.com/report/github.com/Permify/targe\" target=\"_blank\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/Permify/targe?style=for-the-badge\u0026logo=go\" alt=\"Targe Go Report Card\" /\u003e\u003c/a\u003e\u0026nbsp;\n    \u003ca href=\"https://github.com/Permify/targe\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/license/Permify/targe?style=for-the-badge\" alt=\"Targe Licence\" /\u003e\u003c/a\u003e\u0026nbsp;\n    \u003ca href=\"https://discord.gg/n6KfzYxhPp\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/discord/950799928047833088?style=for-the-badge\u0026logo=discord\u0026label=DISCORD\" alt=\"Permify Discord Channel\" /\u003e\u003c/a\u003e\u0026nbsp;\n    \u003ca href=\"https://github.com/Permify/targe/releases\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/permify/targe?include_prereleases\u0026style=for-the-badge\" alt=\"Targe Release\" /\u003e\u003c/a\u003e\u0026nbsp;\n    \u003ca href=\"https://img.shields.io/github/commit-activity/m/Permify/targe?style=for-the-badge\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/commit-activity/m/Permify/targe?style=for-the-badge\" alt=\"Targe Commit Activity\" /\u003e\u003c/a\u003e\u0026nbsp;\n    \u003ca href=\"https://img.shields.io/github/actions/workflow/status/Permify/targe/release.yml?style=for-the-badge\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/Permify/targe/release.yml?style=for-the-badge\" alt=\"GitHub Workflow Status\" /\u003e\u003c/a\u003e\u0026nbsp;\n\u003c/p\u003e  \n\n![Targe Demo](assets/images/targe.gif)\n\n## How it Works?\n\n1. Configure your cloud credentials to enable Targe to access resources in your infrastructure. Currently, Targe supports only AWS.\n2. Start an access flow or use AI to create an access command to fulfill an access request.\n3. Preview the access action and complete the access request.\n\n### Create an Access Command with AI \n\nDescribe the access action you want to perform. For example, \"give S3 read-only access to user Omer.\" \n\nTarge analyzes the request and generates the necessary access command using AI.\n\n![targe-ai-flow](https://github.com/user-attachments/assets/0a2ea874-b6b6-47ec-b792-1602137f23e7)\n\n### Start an Access Flow Manually\n\nYou can also manually start any flow to complete an access action. \n\nThere are three main flows:\n   - `~ % targe aws users`  | Grant or revoke access to/from a user.\n   - `~ % targe aws groups` | Attach or detach a policy to/from a group.\n   - `~ % targe aws roles`  | Attach or detach a policy to/from a role.\n\nLet's repeat the example above of granting s3 read-only access to user Omer.\n\nWe will use following command to start **user** flow: `~ % targe aws users`.\n\nThe user access flow begins by listing the users in the system. Select the user to take action on.\n\n![select-user](https://github.com/user-attachments/assets/d99327e8-3c74-42b4-9615-2afe6f0bde0b)\n\nAfter selecting the user, choose the operation to perform. Let’s attach a policy to user Omer.\n\n![select-operation](https://github.com/user-attachments/assets/bfa67375-0cd1-4bcf-9d73-dcb1a7a88dc4)\n\nIn the next step, select the policy you want to attach. You can use \"filters\" in each section to search what you need.\n\n![select-policy](https://github.com/user-attachments/assets/af918b77-7e45-4c43-9d4b-f8971b1ece47)\n\nFinally, preview the access action.\n\n![preview-access-action](https://github.com/user-attachments/assets/d843bd92-db6d-4907-ab39-0344e4986da8)\n\n## Installation Steps\n\n1. **Install Targe CLI:**\n   ```shell\n   brew tap permify/tap-targe\n   brew install targe\n   ```\n\n2. **Set Up AWS Credentials:**\n\n   Targe requires AWS credentials to be configured in the file `~/.aws/credentials`. Follow these steps:\n\n    - Create or open the `~/.aws/credentials` file using a text editor:\n      ```shell\n      nano ~/.aws/credentials\n      ```\n\n    - Add your AWS credentials in the following format:\n      ```plaintext\n      [default]\n      aws_access_key_id = your_access_key\n      aws_secret_access_key = your_secret_key\n      ```\n\n    - Save the file and exit (in nano, press `CTRL + O` to save, then `CTRL + X` to exit).\n\n3. **Verify the Configuration:**\n\n   Run the following command to confirm the credentials are set correctly:\n   ```shell\n   aws sts get-caller-identity\n   ```\n   This should return information about your AWS account. If it fails, double-check the credentials file for accuracy.\n\n4. **Configure OpenAI API Key**\n   \n   Run the following command to configure your OpenAI API Key:\n   ```shell\n   targe config set openai_api_key [your_api_key]\n   ```\n\n5. **Set the Default Region (Optional):**\n\n   If your tool requires a specific AWS region, you can set it in the `~/.aws/config` file:\n   ```shell\n   nano ~/.aws/config\n   ```\n   Add:\n   ```plaintext\n   [default]\n   region = us-east-1\n   ```\n   Replace `us-east-1` with your desired region.\n\n## Communication Channels\n\nIf you like Targe, please consider giving us a :star:\n\n\u003cp align=\"left\"\u003e\n\u003ca href=\"https://discord.gg/n6KfzYxhPp\"\u003e\n \u003cimg height=\"70px\" width=\"70px\" alt=\"permify | Discord\" src=\"https://user-images.githubusercontent.com/39353278/187209316-3d01a799-c51b-4eaa-8f52-168047078a14.png\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/GetPermify\"\u003e\n  \u003cimg height=\"70px\" width=\"70px\" alt=\"permify | Twitter\" src=\"https://user-images.githubusercontent.com/39353278/187209323-23f14261-d406-420d-80eb-1aa707a71043.png\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/company/permifyco\"\u003e\n  \u003cimg height=\"70px\" width=\"70px\" alt=\"permify | Linkedin\" src=\"https://user-images.githubusercontent.com/39353278/187209321-03293a24-6f63-4321-b362-b0fc89fdd879.png\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpermify%2Ftarge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpermify%2Ftarge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpermify%2Ftarge/lists"}