jitocu

Jira to ClickUp - Copy Jira issues assigned to you to ClickUp 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 bottom-left corner
3. Select Settings
4. Click Apps 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"

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
• Persistent configuration storage with JSON
• Interactive CLI with fuzzy search
• Loading states and error handling
• Atomic settings updates

License

MIT