Terminal Integration

BugToMe from your Terminal

Manage bugs, tickets, and sprints directly from the command line. The fastest way to interact with BugToMe.

What is BugToMe CLI?

A powerful command-line interface to interact with BugToMe without leaving your terminal

BugToMe CLI is a Node.js tool built with oclif that gives you full control of your bug tracking workflow from the terminal. Authenticate once, then manage tickets, projects, sprints and reports with fast, scriptable commands.

How it works

Your Terminal

Shell / Scripts

bugtome CLI

Node.js / oclif

BugToMe

REST API

Setup in 3 steps

Get up and running in under 2 minutes

1

Install the CLI

Install BugToMe CLI globally with npm or npx:

Terminal
npm install -g bugtome-cli

Or use npx without installing:

Terminal
npx bugtome-cli --help
2

Authenticate

Login with your BugToMe account credentials:

Terminal
bugtome login
Tip: Your session is saved locally. You only need to login once per machine.
3

Set your organization

Configure the active organization for your commands:

Terminal
bugtome config set-org my-organization

Run bugtome whoami to confirm your setup is complete.

Available Commands

Full control of your workflow from the terminal

Authentication

3 commands
bugtome login Authenticate with your BugToMe account
bugtome logout Sign out from your account
bugtome whoami Display current authenticated user

Configuration

2 commands
bugtome config show Show current CLI configuration
bugtome config set-org [ORG_SLUG] Set the active organization

Tickets

10 commands
bugtome tickets list [--status] [--priority] [--project] List tickets with optional filters
bugtome tickets create Create a new ticket interactively
bugtome tickets show [TICKET_ID] Show ticket details
bugtome tickets update [TICKET_ID] Update ticket fields
bugtome tickets delete [TICKET_ID] Delete a ticket
bugtome tickets search [QUERY] Full-text search in tickets
bugtome tickets comment [TICKET_ID] Add a comment to a ticket
bugtome tickets complete [TICKET_ID] Mark a ticket as complete
bugtome tickets take [TICKET_ID] Assign a ticket to yourself
bugtome tickets export [--format csv|json] Export tickets to CSV or JSON

Projects

1 commands
bugtome projects List all projects in the organization

Sprints

7 commands
bugtome sprints list List all sprints
bugtome sprints show [SPRINT_ID] Show sprint details
bugtome sprints activate [SPRINT_ID] Activate a sprint
bugtome sprints complete [SPRINT_ID] Complete an active sprint
bugtome sprints cancel [SPRINT_ID] Cancel a sprint
bugtome sprints add-ticket [SPRINT_ID] [TICKET_ID] Add a ticket to a sprint
bugtome sprints remove-ticket [SPRINT_ID] [TICKET_ID] Remove a ticket from a sprint

Reports

6 commands
bugtome reports list List all reports
bugtome reports show [REPORT_ID] Show report details
bugtome reports create Create a new report
bugtome reports analyze [REPORT_ID] AI analysis of a report
bugtome reports convert [REPORT_ID] Convert report to ticket
bugtome reports reject [REPORT_ID] Reject a report

Other

3 commands
bugtome members List organization members
bugtome orgs List your organizations
bugtome stats Show organization statistics

Practical Examples

Common workflows with BugToMe CLI

Create and assign a ticket

Quickly create a new bug ticket and assign it to yourself

Terminal
# Create a new ticket
bugtome tickets create

# List your tickets and take ownership
bugtome tickets list --status open
bugtome tickets take TKT-42

# Add a comment
bugtome tickets comment TKT-42

Sprint management

List open tickets and add them to the active sprint

Terminal
# List active sprints
bugtome sprints list

# Show sprint details
bugtome sprints show SPR-3

# Add tickets to sprint
bugtome sprints add-ticket SPR-3 TKT-42
bugtome sprints add-ticket SPR-3 TKT-55

# Activate the sprint
bugtome sprints activate SPR-3

Export and analyze

Export tickets and generate a report with AI analysis

Terminal
# Export all open tickets to CSV
bugtome tickets export --format csv

# Search for critical bugs
bugtome tickets search "authentication" --priority critical

# Create and analyze a report
bugtome reports create
bugtome reports analyze RPT-7

# View organization stats
bugtome stats

Ready to work faster from your terminal?

Sign up now and install BugToMe CLI in seconds.