Tag: developer tools

Introducing gforge-cli: GForge from Your Terminal

Posted on by gforgegroup

If you’re a developer who lives in the terminal, context-switching to a web browser just to check your tickets or create a branch feels like friction. That’s why we built gforge-cli—a command-line tool that brings GForge to where you already work.

What It Does

gforge-cli lets you interact with GForge directly from your terminal. Check assigned tickets, change statuses, create branches linked to issues, and access any API endpoint—all without leaving your workflow.

Here’s what’s available:

gforge login --server https://your-gforge-instance.com
gforge ticket list --project myproject
gforge ticket view 12345
gforge ticket transitions 12345
gforge ticket transition 12345 "Works for Me"
gforge branch 12345 "Add user authentication"
gforge api /api/project/myproject/tracker

The tool works with both Git and SVN repositories. When you create a branch with gforge branch, the ticket ID is automatically embedded in the branch name for traceability—no more manually typing feature/12345-description.

Quick Start

1. Download and install from gforge.com/gforge-cli

2. Authenticate with your GForge server:

gforge login --server https://next.gforge.com

3. List your tickets:

gforge ticket list

Session tokens are stored securely in ~/.config/gforge/, so you only need to authenticate once per server.

Use Cases

Morning standup prep: Pull up your assigned tickets in seconds.

gforge ticket list --project gforge-development

Start work on a ticket: Create a linked branch without copying IDs.

gforge branch 47397 "Add manual search to nav bar"
# Creates: feature/47397-add-manual-search-to-nav-bar

Finish a task: Update the ticket status from your terminal.

gforge ticket transition 47397 "Works for Me"

CI/CD automation: Script GForge interactions in your pipelines. The gforge api command gives you raw access to any endpoint:

gforge api GET /api/project/myproject/tracker/item/47397
gforge api POST /api/project/myproject/tracker/item --data '{"summary":"New ticket"}'

What’s Next

We’re actively developing gforge-cli. Wiki commands for managing documentation are coming soon—create, edit, and publish wiki pages without leaving your editor.

Have a feature request? Let us know at feedback@gforgegroup.com.

Get Started

Download gforge-cli and bring GForge into your terminal workflow.