{"id":50614588,"url":"https://github.com/algodesigner/ghman","last_synced_at":"2026-06-06T07:02:36.390Z","repository":{"id":339748164,"uuid":"1163200057","full_name":"algodesigner/ghman","owner":"algodesigner","description":"A simple GitHub repository manager CLI utility designed to streamline your workflow.","archived":false,"fork":false,"pushed_at":"2026-02-21T10:34:43.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-21T16:32:06.284Z","etag":null,"topics":["cli","cli-tool","github"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/algodesigner.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-21T08:51:36.000Z","updated_at":"2026-02-21T10:34:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/algodesigner/ghman","commit_stats":null,"previous_names":["algodesigner/ghman"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/algodesigner/ghman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algodesigner%2Fghman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algodesigner%2Fghman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algodesigner%2Fghman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algodesigner%2Fghman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/algodesigner","download_url":"https://codeload.github.com/algodesigner/ghman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algodesigner%2Fghman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33972398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","cli-tool","github"],"created_at":"2026-06-06T07:02:35.615Z","updated_at":"2026-06-06T07:02:36.383Z","avatar_url":"https://github.com/algodesigner.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ghman\n\nA simple GitHub repository manager CLI utility designed to streamline your workflow. `ghman` saves you time by automating the creation and linking of local projects to GitHub in a single command, and provides a quick way to list and track all your existing repositories directly from the terminal.\n\n## Prerequisites\n\n- Python 3.6+\n- A GitHub Personal Access Token (PAT) with `repo` and `delete_repo` scopes.\n\n## Installation\n\n### One-Step Installation (Recommended)\n\nRun the included installation script to set up dependencies and permissions automatically:\n\n```bash\n./install.sh\n```\n\n### Manual Installation\n\n1. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n2. Make the script executable:\n   ```bash\n   chmod +x ghman.py\n   ```\n\n## Uninstallation\n\nTo remove `ghman`'s configuration and symlinks, run:\n\n```bash\n./uninstall.sh\n```\n\nThis will:\n- Remove the symlink from `/usr/local/bin/ghman` (if present).\n- Optionally remove the configuration directory and saved token (`~/.ghman`).\n\n## Configuration\n\n### Obtain a GitHub Personal Access Token (PAT)\n\nTo use `ghman`, you need a GitHub PAT with `repo` and `delete_repo` scopes:\n\n1.  Log in to your [GitHub account](https://github.com).\n2.  Navigate to **Settings** \u003e **Developer settings** \u003e **Personal access tokens** \u003e **Tokens (classic)**.\n3.  Click **Generate new token** (select **Generate new token (classic)**).\n4.  Give it a descriptive name (e.g., \"ghman CLI\").\n5.  Select the **`repo`** and **`delete_repo`** scopes (this allows creating, managing, and deleting repositories).\n6.  Click **Generate token** at the bottom.\n7.  **Copy the token immediately**—you won't be able to see it again!\n\n### Set Environment Variable\n\nSet your PAT as an environment variable in your terminal session:\n\n```bash\nexport GITHUB_TOKEN=your_token_here\n```\n\n### Persistent Configuration (Recommended)\n\nFor a safer and more permanent way to store your token, use the `auth` command. This will save your token to `~/.ghman/config.json` and set the file permissions to `600` (readable only by you):\n\n```bash\n./ghman auth\n```\nYou will be prompted to enter your token securely (input will be hidden). Alternatively, you can pass it directly:\n```bash\n./ghman auth --token your_token_here\n```\n\n\u003e [!TIP]\n\u003e `ghman` will check the `GITHUB_TOKEN` environment variable first. If not found, it will look for the saved token in `~/.ghman/config.json`.\n\n## Usage\n\n### List Repositories\nList all repositories on your GitHub account:\n```bash\n./ghman list\n```\n\n### Add Local Repository\nAdd the current directory as a new or existing repository on GitHub:\n```bash\n./ghman add [repo-name]\n```\n\nOptions:\n- `[repo-name]`: Optional name for the GitHub repository (defaults to the current directory name).\n- `--public`: Create a public repository (default is private).\n\n### Delete Repository\nDelete a repository from GitHub (requires confirmation):\n```bash\n./ghman delete [repo-name]\n```\n\n## Features\n- Checks if a repository already exists on GitHub and link to it if so.\n- Requires an existing local Git repository.\n- Adds the correct remote and pushes local code.\n## License\n\nThis project is licensed under the BSD 3-Clause License - see the [LICENSE](file:///Users/vlad/.gemini/antigravity/scratch/ghman/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgodesigner%2Fghman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falgodesigner%2Fghman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgodesigner%2Fghman/lists"}