Blame · Line-by-line history
STANDALONE_CLI.md
Each line is annotated with the commit that last touched it. Click any SHA to jump to that commit and see the surrounding change.
| 573a806 | 1 | # Gluecron CLI (`gc`) |
| 2 | ||
| 3 | The `gc` CLI replaces `git` + `gh` + GitHub Actions CLI with a single tool that understands your entire development workflow. | |
| 4 | ||
| 5 | ## Installation | |
| 6 | ||
| 7 | ```bash | |
| 8 | # Via Bun | |
| 9 | bun install -g gluecron | |
| 10 | ||
| 11 | # Via install script | |
| 12 | curl -fsSL https://get.gluecron.com | sh | |
| 13 | ``` | |
| 14 | ||
| 15 | ## Configuration | |
| 16 | ||
| 17 | ```bash | |
| 18 | export GLUECRON_URL=https://your-gluecron-instance.com | |
| 19 | export GLUECRON_TOKEN=gc_your_api_token | |
| 20 | ||
| 21 | # Or run once: | |
| 22 | gc auth login | |
| 23 | ``` | |
| 24 | ||
| 25 | ## Core Commands | |
| 26 | ||
| 27 | ### Repository | |
| 28 | ```bash | |
| 29 | gc init # Initialise a new Gluecron repo | |
| 30 | gc clone owner/repo # Clone a repo | |
| 31 | gc push # Push changes (like git push, but smarter) | |
| 32 | gc push --draft # Push and open a draft PR | |
| 33 | ``` | |
| 34 | ||
| 35 | ### Pull Requests | |
| 36 | ```bash | |
| 37 | gc pr create # Open a PR (AI generates title + description) | |
| 38 | gc pr create --ai-description # AI writes full PR description from diff | |
| 39 | gc pr review # Get AI review of the current branch | |
| 40 | gc pr review --file src/auth.ts # AI review focused on a specific file | |
| 41 | gc pr merge # Merge current PR | |
| 42 | gc pr list # List open PRs | |
| 43 | ``` | |
| 44 | ||
| 45 | ### CI | |
| 46 | ```bash | |
| 47 | gc ci status # Show CI status for current branch | |
| 48 | gc ci logs # Stream CI logs | |
| 49 | gc ci rerun # Rerun failed CI jobs | |
| 50 | ``` | |
| 51 | ||
| 52 | ### Deployment | |
| 53 | ```bash | |
| 54 | gc deploy # Trigger deploy for current branch | |
| 55 | gc deploy --env production # Deploy to specific environment | |
| 56 | gc logs --env production # Stream production logs | |
| 57 | gc rollback # Rollback last deployment | |
| 58 | ``` | |
| 59 | ||
| 60 | ### AI Features | |
| 61 | ```bash | |
| 62 | gc ai ask "why is the auth test failing" # Ask about the codebase | |
| 63 | gc ai ask "where do we handle rate limiting" # Semantic code search via CLI | |
| 64 | gc ai review # Full AI code review | |
| 65 | gc ai fix # AI suggests fixes for current errors | |
| 66 | gc ai docs # Generate docs for changed files | |
| 67 | ``` | |
| 68 | ||
| 69 | ### Issues | |
| 70 | ```bash | |
| 71 | gc issue create # Create issue (AI suggests labels/assignees) | |
| 72 | gc issue list # List issues | |
| 73 | gc issue close 42 # Close issue | |
| 74 | ``` | |
| 75 | ||
| 76 | ## Flywheel Integration | |
| 77 | ||
| 78 | Every `gc ai ask` response includes an implicit feedback mechanism: | |
| 79 | ||
| 80 | ```bash | |
| 81 | gc ai ask "how does billing work" | |
| 82 | # Response displayed... | |
| 83 | # Was this helpful? [y/n/e (elaborate)] | |
| 84 | ``` | |
| 85 | ||
| 86 | Ratings feed directly into the Gluecron AI flywheel, improving answer quality for your specific codebase over time. | |
| 87 | ||
| 88 | ## Offline Mode | |
| 89 | ||
| 90 | The CLI caches a compressed semantic index of your repo locally. When offline: | |
| 91 | - `gc ai ask` works against the local index (last synced at most recent `gc push`) | |
| 92 | - Responses are marked `[offline — index from <timestamp>]` | |
| 93 | - Full accuracy resumes on next network connection | |
| 94 | ||
| 95 | ## Environment Variables | |
| 96 | ||
| 97 | | Variable | Description | | |
| 98 | |----------|-------------| | |
| 99 | | `GLUECRON_URL` | URL of your Gluecron instance | | |
| 100 | | `GLUECRON_TOKEN` | API token for authentication | | |
| 101 | | `GLUECRON_OFFLINE` | Set to `1` to force offline mode | | |
| 102 | | `GLUECRON_NO_FLYWHEEL` | Set to `1` to disable telemetry (not recommended) | |