{"id":35214826,"url":"https://github.com/stefanodecillis/argo-rs","last_synced_at":"2026-01-21T15:02:45.771Z","repository":{"id":330878799,"uuid":"1123817254","full_name":"stefanodecillis/argo-rs","owner":"stefanodecillis","description":"Interactive TUI and powerful CLI for pull requests, branches, commits, and AI-powered development workflows.","archived":false,"fork":false,"pushed_at":"2026-01-03T14:32:09.000Z","size":1378,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-07T10:54:06.751Z","etag":null,"topics":["ai","cli","git","tui","tui-rs"],"latest_commit_sha":null,"homepage":"https://argo.stefanodecillis.com/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefanodecillis.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":"2025-12-27T17:28:31.000Z","updated_at":"2026-01-06T18:21:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/stefanodecillis/argo-rs","commit_stats":null,"previous_names":["stefanodecillis/argo-rs"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/stefanodecillis/argo-rs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanodecillis%2Fargo-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanodecillis%2Fargo-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanodecillis%2Fargo-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanodecillis%2Fargo-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefanodecillis","download_url":"https://codeload.github.com/stefanodecillis/argo-rs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanodecillis%2Fargo-rs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28401055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"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":["ai","cli","git","tui","tui-rs"],"created_at":"2025-12-29T21:25:15.721Z","updated_at":"2026-01-13T21:40:51.279Z","avatar_url":"https://github.com/stefanodecillis.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# argo-rs\n\nA terminal application with TUI for managing GitHub repositories.\n\n\u003e **Note:** The command is `argo`. If you have `gr` aliased to `git remote` (common in oh-my-zsh), this avoids the conflict.\n\n## Installation\n\n### Quick Install (macOS/Linux)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/stefanodecillis/argo-rs/main/install.sh | bash\n```\n\nThis will:\n- Detect your platform (macOS/Linux, x86_64/aarch64)\n- Download the latest release\n- Install `argo` to `~/.local/bin/`\n- Sign the binary on macOS for Keychain compatibility\n\n### Build from Source\n\n**Prerequisites:**\n- [Rust](https://rustup.rs/) (1.70 or later)\n- Git\n\n```bash\n# Clone the repository\ngit clone https://github.com/stefanodecillis/argo-rs.git\ncd argo-rs\n\n# Build release binary\ncargo build --release\n\n# Install to your PATH\ncp target/release/argo ~/.local/bin/\n```\n\nMake sure `~/.local/bin` is in your PATH:\n\n```bash\n# Add to ~/.bashrc or ~/.zshrc\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\n### Updating\n\nTo update to the latest version, simply run the install script again:\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/stefanodecillis/argo-rs/main/install.sh | bash\n```\n\n### Uninstalling\n\n**Quick Uninstall (macOS/Linux):**\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/stefanodecillis/argo-rs/main/uninstall.sh | bash\n```\n\nThis will remove binaries and optionally remove configuration files. Stored credentials must be removed manually (the script will provide instructions).\n\n**Manual Uninstall:**\n\n```bash\n# Remove binary\nrm -f ~/.local/bin/argo\n\n# Remove configuration (macOS)\nrm -rf ~/Library/Application\\ Support/com.argo-rs.argo-rs\n\n# Remove configuration (Linux)\nrm -rf ~/.config/argo-rs\n```\n\nFor credentials, open your system's keychain/password manager and search for \"argo-rs\" entries.\n\n## Features\n\n- **GitHub Authentication**: OAuth Device Flow for secure browser-based login\n- **Pull Request Management**: List, create, view, comment, and merge PRs\n- **Branch Operations**: List and delete remote branches\n- **Commit Creation**: Stage files and create commits with messages\n- **AI Integration**: Generate commit messages and PR descriptions using Gemini AI\n- **TUI Mode**: Interactive terminal UI with vim-style navigation\n- **Polling**: Real-time updates for PR comments\n\n## Quick Start\n\n1. **Authenticate with GitHub**:\n   ```bash\n   argo auth login\n   ```\n\n2. **Navigate to a git repository and launch TUI**:\n   ```bash\n   cd your-repo\n   argo\n   ```\n\n3. **Or use CLI commands directly**:\n   ```bash\n   argo pr list\n   argo pr create --title \"My PR\" --body \"Description\"\n   argo commit -m \"feat: add new feature\"\n   ```\n\n## CLI Commands\n\n### Authentication\n\n```bash\nargo auth login     # Login via OAuth Device Flow\nargo auth logout    # Remove stored credentials\nargo auth status    # Check authentication status\n```\n\n### Pull Requests\n\n```bash\nargo pr list                          # List open PRs\nargo pr list --state=all              # List all PRs\nargo pr list --author=username        # Filter by author\n\nargo pr create --title \"Title\"        # Create PR with title\nargo pr create --ai                   # Create PR with AI-generated title/body\nargo pr create --draft                # Create as draft PR\n\nargo pr view 123                      # View PR #123 with comments\nargo pr comment 123 \"Great work!\"     # Add comment to PR #123\n\nargo pr merge 123                     # Merge PR #123 (merge commit)\nargo pr merge 123 --squash            # Squash and merge\nargo pr merge 123 --rebase            # Rebase and merge\nargo pr merge 123 --delete            # Delete branch after merge\n```\n\n### Branches\n\n```bash\nargo branch list                      # List remote branches\nargo branch delete feature-branch     # Delete remote branch\nargo branch delete old-branch --force # Delete without confirmation\n```\n\n### Commits\n\n```bash\nargo commit -m \"commit message\"       # Commit staged changes\nargo commit -a -m \"message\"           # Stage all and commit\nargo commit --ai                      # Generate message with AI\nargo commit -a --ai                   # Stage all + AI message\n```\n\n### Configuration\n\n```bash\nargo config set gemini-key YOUR_KEY   # Set Gemini API key for AI features\nargo config get gemini-key            # Check if key is configured\nargo config set gemini-model MODEL    # Set AI model\nargo config get gemini-model          # Show current model\n```\n\n#### Available Gemini Models\n\n- `gemini-2.0-flash`\n- `gemini-2.5-flash` (default)\n- `gemini-3-flash-preview`\n\n## TUI Mode\n\nLaunch the interactive TUI by running `argo` without arguments:\n\n```bash\nargo\n```\n\n### Key Bindings\n\n| Key | Action |\n|-----|--------|\n| `j` / `Down` | Move down |\n| `k` / `Up` | Move up |\n| `Enter` | Select / Confirm |\n| `Esc` / `q` | Back / Quit |\n| `p` | Go to PR list |\n| `c` | Go to commit screen |\n| `s` | Go to settings |\n| `n` | New PR (in PR list) |\n| `r` | Refresh |\n\n## Requirements\n\n- Git repository with GitHub remote\n- macOS or Linux\n- For AI features: Gemini API key\n\n## Supported Platforms\n\nPre-built binaries are available for the following platforms:\n\n| Platform | Architecture | Download |\n|----------|--------------|----------|\n| macOS | Apple Silicon (M1/M2/M3) | `argo-macos-aarch64.tar.gz` |\n| Linux | x86_64 | `argo-linux-x86_64.tar.gz` |\n\nFor other platforms (macOS Intel, Linux ARM64), please build from source.\n\n## Configuration\n\nConfiguration is stored in:\n- **macOS**: `~/Library/Application Support/com.argo-rs.argo-rs/config.toml`\n- **Linux**: `~/.config/argo-rs/config.toml`\n\nCredentials (GitHub token, Gemini API key) are stored securely in:\n- **macOS**: Keychain\n- **Linux**: Secret Service (GNOME Keyring, KWallet, etc.)\n\n### GitHub OAuth\n\nargo-rs uses GitHub's OAuth Device Flow for authentication. The OAuth app is registered under the argo-rs project. When you run `argo auth login`, you'll be redirected to GitHub to authorize the official argo-rs application.\n\n## Development\n\n```bash\n# Clone\ngit clone https://github.com/stefanodecillis/argo-rs.git\ncd argo-rs\n\n# Build\ncargo build\n\n# Run\ncargo run -- --help\n\n# Test\ncargo test\n\n# Format\ncargo fmt\n\n# Lint\ncargo clippy\n```\n\n## License\n\nMIT - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanodecillis%2Fargo-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefanodecillis%2Fargo-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanodecillis%2Fargo-rs/lists"}