A fast, modern CLI for Jira and Confluence built with Bun and TypeScript. Features local caching with instant search and AI-powered Q&A.
Key benefits:
- ⚡ Lightning fast - local caching means <50ms searches
- 🔍 Smart search - finds what you need with typo tolerance
- 🤖 AI assistant - ask questions about your knowledge base
- 🔄 Always fresh - automatic background sync
- Bun - JavaScript runtime (install:
curl -fsSL https://bun.sh/install | bash)
git clone https://github.com/aaronshaf/ji.git
cd ji
bun install
bun linkNow you can use ji from anywhere!
ji initThis interactive wizard will:
- Set up your Atlassian credentials
- Install search tools (Meilisearch)
- Optionally set up AI features (Ollama)
- Sync your first project/space
# View your assigned issues
ji mine
# View a specific issue (two ways)
ji PROJ-123 # Shorthand
ji issue view PROJ-123 # Full command
# Take ownership of an issue
ji take PROJ-456
# View current sprint
ji sprint# Search everything
ji search "login bug"
# Search only Confluence
ji search "api docs" --source confluence
# Ask the AI assistant
ji ask "How do we deploy to production?"# Sync a Jira project
ji issue sync PROJ
# Sync a Confluence space
ji confluence sync DOCS
# Sync all your workspaces
ji syncAll data is cached locally in SQLite with full-text search. Searches complete in milliseconds, even offline.
With Ollama installed, ask natural language questions about your knowledge base:
ji ask "What's our API rate limit?"
ji ask "Who owns the payment service?"- Incremental sync only fetches changes
- Background refresh keeps data current
- Works offline with cached data
ji sprint # Current sprint overview
ji sprint unassigned # Unassigned issues
ji board PROJ # View project boardBuilt-in testing for environment-specific commands:
ji test --setup # Configure tests for your environment
ji test # Run all configured testsFeatures:
- Environment-specific test cases (real issue keys, projects)
- LLM-based validation for
ji askresponses - Comprehensive coverage of all commands
- Pass/fail reporting with statistics
-
Speed up searches with source filters:
ji search "error" --source jira --limit 20 -
Remember facts for the AI:
ji remember "Our staging URL is https://staging.example.com" -
Sync in background:
ji confluence sync LARGE_SPACE --background
-
View recent changes:
ji confluence recent ENG
- DOCS.md - Complete command reference and advanced usage
- CLAUDE.md - Development notes and architecture
# Setup
ji init # First-time setup
ji auth # Configure credentials
# Jira
ji mine # Your issues
ji <ISSUE-KEY> # View issue (shorthand)
ji issue view <KEY> # View issue (full command)
ji take <KEY> # Assign to yourself
ji sprint [PROJECT] # Sprint overview
# Confluence
ji confluence sync <SPACE> # Sync space
ji confluence recent <SPACE> # Recent changes
# Search & AI
ji search "query" # Search everything
ji ask "question" # AI Q&A
# Maintenance
ji sync # Sync all workspaces
ji index # Rebuild search index
# Testing
ji test --setup # Configure environment tests
ji test # Run all testsMIT