A terminal-based CLI tool to book time in Jira using the Tempo plugin by parsing your current Git branch name.
- 🖼️ Ink — React for CLIs with beautiful terminal UI
- 🧠 TypeScript — Strong typing and better developer experience
- 🌲 Biome — Fast linting and formatting
- 🌐 better-fetch — Modern fetch API for HTTP requests
- ⏱️ Tempo API integration — Log time directly to Jira tickets
- 🌿 Git integration — Automatically parse Jira ticket IDs from branch names
- 🎯 Flexible ticket input — Specify ticket explicitly or use Git branch
Using npm:
npm install bookr-cliUsing yarn:
yarn add bookr-cliUsing pnpm:
pnpm add bookr-cliUsing bun:
bun add bookr-cli# Clone the repository
git clone <repository-url>
cd bookr
# Install dependencies
npm install
# Build the project
npm run build
# Run the CLI
npm start# Basic usage (uses Git branch for ticket)
bookr 2h15m
# Log time with explicit ticket
bookr PROJ-123 2h15m
# Log time with description
bookr 2h15m -m "Worked on CLI"
bookr PROJ-123 2h15m -m "Fixed bug in login"
# Log time for specific date
bookr --date "2024-01-15" 4h
bookr PROJ-456 --date "2024-01-15" 4h
# View today's worklogs
bookr today
# View sprint overview
bookr sprint
# View sprint progress
bookr progress
# Check for updates
bookr update
# Get help
bookr --help
# Show version
bookr --version- Fork the repository
- Create a feature branch
- Make your changes
- Run
npm run checkto ensure code quality - Submit a pull request
ISC License - see package.json for details.