Claude Tools

Multi-purpose CLI for Claude Code workflows - spawn sessions, Telegram messaging, Jira integration.

Installation

npm install
npm run build

Usage

# Show all commands
claude-tools --help

# Spawn Claude session with custom window title
claude-tools spawn --name "Code Review"
claude-tools spawn prompt.txt --name "My Task"

# Telegram commands
claude-tools telegram chats              # List your chats
claude-tools telegram read               # Read saved messages
claude-tools telegram read @username     # Read from user
claude-tools telegram send @user "Hi"    # Send message
claude-tools telegram search "keyword"   # Search messages

# Jira commands
claude-tools jira list                   # List issues
claude-tools jira list ELD               # List project issues
claude-tools jira create "Bug title"     # Create issue
claude-tools jira status ELD-123 "Done"  # Update status
claude-tools jira comment ELD-123 "msg"  # Add comment
claude-tools jira search "assignee = me" # JQL search

Configuration

Secrets (never commit)

Location: ~/.config/claude-tools/secrets.json (Linux/Mac) or %APPDATA%\claude-tools\secrets.json (Windows)

{
  "telegram": {
    "apiId": 12345678,
    "apiHash": "your_api_hash",
    "sessionString": "your_session_string"
  },
  "jira": {
    "email": "[email protected]",
    "apiToken": "your_jira_api_token"
  }
}

Project Config (can commit)

Location: .claude-tools.json in project root

{
  "jira": {
    "host": "yourcompany.atlassian.net",
    "defaultProject": "ELD"
  },
  "telegram": {
    "defaultChat": "me"
  }
}

Environment Variables

Override config with environment variables:

# Telegram
TELEGRAM_API_ID=12345678
TELEGRAM_API_HASH=abc123...
TELEGRAM_SESSION_STRING=...

# Jira
JIRA_HOST=yourcompany.atlassian.net
[email protected]
JIRA_API_TOKEN=...

Telegram Setup

1. Get API credentials from https://my.telegram.org/apps
2. Run the session generator:

   npm run telegram-auth

3. Follow the prompts to authenticate
4. Session is saved to secrets.json

Jira Setup

1. Get API token from https://id.atlassian.com/manage-profile/security/api-tokens
2. Add to secrets.json or set environment variables

Commands

Spawn Commands

| Command | Description | |---------|-------------| | spawn [file] | Spawn Claude session | | list | List all tasks | | cleanup | Remove task records |

Options: --name (window title), --dir (working directory)

Telegram Commands

| Command | Description | |---------|-------------| | telegram auth | Generate session | | telegram chats | List your chats | | telegram read [chat] | Read messages | | telegram send <chat> <msg> | Send message | | telegram search <query> | Search messages |

Chat can be: me, @username, chat ID, or chat title

Jira Commands

| Command | Description | |---------|-------------| | jira list [project] | List issues | | jira search <jql> | JQL search | | jira create <summary> | Create issue | | jira status <issue> <status> | Update status | | jira comment <issue> <text> | Add comment | | jira show <issue> | Show details |

Development

# Run in dev mode
npm run dev

# Build
npm run build

# Generate Telegram session
npm run telegram-auth

Dependencies

• commander - CLI framework
• chalk - Terminal colors
• telegram - GramJS Telegram client
• jira.js - Jira Cloud API client
• koffi - Windows API bindings (for spawn)