jitocu

Jira to ClickUp - Copy Jira issues assigned to you to ClickUp and manage time entries with an interactive terminal UI.

Prerequisites

• Bun runtime installed (required for development only)
• Jira account with API access
• ClickUp account with API access

Installation

Install globally via npm:

npm install -g jitocu

Or with Bun:

bun install -g jitocu

After installation, configure your credentials:

jitocu config

Note: The config command will detect missing settings and prompt you to set them up interactively. You can also set values manually using jitocu config set <path> <value>.

Getting API Tokens

Jira API Token

1. Go to Atlassian Account Settings
2. Click "Create API token"
3. Give it a label and copy the token

ClickUp API Token

1. Log in to your ClickUp account
2. Click your avatar in the top-right corner
3. Select Settings
4. Click ClickUp API in the left sidebar
5. Under "API Token", click Generate (or Regenerate if you already have one)
6. Click Copy to copy your API token
7. Store it securely - you won't be able to see it again

ClickUp Workspace ID

1. Log in to ClickUp and navigate to your workspace
2. Click Settings in the sidebar
3. Click Workspaces
4. Your Workspace ID is displayed under the workspace name (it's a numeric ID like 1234567)
5. Alternatively, you can find it in the URL when viewing your workspace: https://app.clickup.com/{WORKSPACE_ID}/...

Usage

Configuration

Configure your Jira and ClickUp credentials:

jitocu config

The config command will:

• Check for missing settings
• Prompt you to set them up interactively if any are missing
• Guide you through the setup process

Manual configuration (optional):

# Set individual values
jitocu config set jira.domain 'your-domain.atlassian.net'
jitocu config set jira.email '[email protected]'
jitocu config set jira.apiToken 'your-jira-token'
jitocu config set clickUp.apiToken 'your-clickup-token'
jitocu config set clickUp.workspaceId 'your-workspace-id'

# View a specific setting
jitocu config get jira.domain

# List all settings
jitocu config list

Interactive Copy (Main Feature)

Copy Jira issues to ClickUp interactively:

jitocu

Workflow:

1. 🔍 Search Issues - Type to fuzzy search your Jira issues
2. ✅ Select Issue - Choose the issue you want to copy
3. 📁 Choose Folder - Select a ClickUp shared folder
4. 📋 Choose List - Select a list within the folder
5. ✨ Task Created - Your Jira issue is now in ClickUp!

Create Single Ticket

Quickly create a ClickUp task from a Jira issue without interactive prompts:

jitocu create --key PROJ-123 --list "My List Name"

Required flags:

• -k, --key <ISSUE-KEY> - Jira issue key (e.g., PROJ-123)
• -l, --list <LIST-NAME> - ClickUp list name where the task will be created

Example:

jitocu create -k PROJ-456 -l "Sprint Backlog"

Time Entry Management

Manage time entries for your ClickUp tasks with interactive timesheets and manual entry.

Interactive Time Management

View and manage time entries in a spreadsheet-like interface:

jitocu time

Workflow:

1. 📅 Select Week Range - Choose from current and previous weeks
2. 📊 View Timesheet - Interactive table showing tasks and time entries
3. ⏰ Add Time - Click cells to add time or use keyboard shortcuts
4. ✏️ Time Entry - Enter time using natural language (e.g., "from 9am to 5pm")

Timesheet Navigation:

• Arrow Keys/ hjkl: Navigate cells
• Enter: Select cell to add/edit time
• A: Add time entry from task selection mode
• Q/Esc: Exit

Manual Time Entry

Add time entries directly without the timesheet interface:

jitocu time add --list "My List Name"

Optional flags:

• -l, --list <LIST-NAME> - ClickUp list name (prompts if not provided)

Time Entry Formats:

Basic Time Range:

• "from 9:00 to 17:00" - 9 AM to 5 PM
• "from 9 to 17" - Whole hours (9 AM to 5 PM)
• "from 9:30 to 17:30" - With minutes

Duration-Based:

• "from 9:00 duration 4h" - Starting at 9 AM for 4 hours
• "from 9:30 duration 2h30m" - Starting at 9:30 AM for 2.5 hours
• "from 14:00 duration 1h59m" - Starting at 2 PM for 1 hour 59 minutes

Multiple Time Blocks:

• "from 9:00 to 12:00 and from 13:00 to 17:00" - Split workday with lunch break
• "from 9:00 to 12:00 and from 13:00 duration 4h" - Mixed range and duration

Edge Cases:

• "from 22:00 to 2:00" - Overnight work (10 PM to 2 AM next day)
• "from 0:00 to 0:00" - Full 24-hour period
• "from 23:59 duration 2h" - Starting at 11:59 PM

Notes:

• Case insensitive: "FROM 9:00 TO 17:00" works
• Extra whitespace is ignored
• Single digit hours don't need leading zeros: "from 9:5 to 17:30"
• Duration must include hours (minutes only not allowed: "duration 30m" invalid)

Example:

jitocu time add -l "Development Tasks"
# Then select task, date, and enter time like "from 9am to 5pm"

Tech Stack

• Runtime: Bun
• Language: TypeScript
• CLI Framework: Commander.js
• Prompts: @inquirer/prompts
• Fuzzy Search: fuzzy
• Loading Indicators: ora
• Styling: chalk

Development

Setup for Contributors

• Clone the repository:

git clone <repository-url>
cd jitocu

• Install dependencies:

bun install

• Configure your credentials:

bun run src/cli.ts config

• Run in development mode with auto-reload:

bun run dev

Build and Test

Build for distribution:

bun run build

Test the built CLI globally:

bun link
jitocu --help

Run tests:

bun test

Key Features

• Type-safe API clients for Jira and ClickUp
• Interactive CLI with fuzzy search for issues and tasks
• Time entry management with spreadsheet-like timesheet interface
• Natural language time parsing (e.g., "from 9am to 5pm")
• Interactive date picker and tree navigation for folders/lists
• Loading states and error handling
• Atomic settings updates
• Persistent configuration storage with JSON

License

MIT