cliend

AI-powered development assistant for the terminal. Uses your Claude account — no API key needed.

Prerequisites

• Node.js >= 22
• Claude CLI (Claude Code) — installed and authenticated

# Install Claude CLI first
npm install -g @anthropic-ai/claude-code
claude  # Log in to your Anthropic account

# Then install cliend
npm install -g @channelfactory/cliend

Quick Start

cliend

╭──────────────────────────── restapi · PI-8390 ──╮
│ > What's the status of this ticket?              │
╰────────────────────────────────── v1.2.0 ─╯

Features

• No API key required — uses your Claude account via Claude CLI
• Bordered input box with multi-line editing (Alt+Enter)
• @file autocomplete — attach files to your message
• /command autocomplete — Tab to complete slash commands
• Paste support — large pastes show as [Pasted text #1 +30 lines]
• Jira integration — auto-detect tickets, post/edit/delete comments
• Bitbucket PR integration — review diffs, post comments
• Session management — persistent conversations per project
• Agentic mode — reads files, runs commands, edits code (with approval)

Commands

| Command | Description | |---------|-------------| | /help | Show available commands | | /ticket <ID> | Load a Jira ticket | | /pr <ID or URL> | Load a Bitbucket pull request | | /auth | Authenticate with Atlassian (OAuth) | | /sessions | List chat sessions | | /resume <N> | Resume a previous session | | /new [name] | Start a new session | | /compact | Compress conversation history | | /undo | Restore files changed by the agent | | /status | Check service connectivity | | /config | View configuration | | /config setup | Re-run setup wizard | | /search <query> | Search Jira & Confluence | | /breakdown <ID> | Break down a ticket into subtasks | | /clear | Clear screen | | /exit | Exit |

Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Alt+Enter | New line (multi-line input) | | \ + Enter | Continue on next line | | Option+Arrow (macOS) | Jump over words | | Alt+Backspace / Ctrl+W | Delete previous word | | Ctrl+A / Ctrl+E | Home / End of line | | Ctrl+U / Ctrl+K | Clear before / after cursor | | Arrow Up/Down | Browse input history | | Tab | Accept autocomplete suggestion | | Escape | Cancel multi-line / dismiss dropdown | | Ctrl+C | Interrupt processing / cancel | | Ctrl+C Ctrl+C | Exit |

Setup

On first run, cliend checks for Claude CLI and prompts for:

1. Atlassian OAuth — Client ID & Secret for Jira/Confluence integration
2. Bitbucket — workspace, repo, API token for PR reviews and Obsidian docs

No AI API keys are needed — Claude CLI handles all AI requests using your Claude account (Pro/Max/Teams).

Atlassian OAuth App

1. Go to developer.atlassian.com/console/myapps
2. Create an OAuth 2.0 integration
3. Add callback URL: http://localhost:3456/callback
4. Add Jira + Confluence permissions
5. Copy Client ID and Secret for the setup wizard

Then run /auth in cliend to connect your Atlassian account.

Architecture

User Input
    │
    ▼
Complexity Router (heuristic)
    │
    ├── simple → Claude CLI (--model sonnet)
    ├── agentic → Claude CLI (--model sonnet) with tool context
    └── complex → Claude CLI (--model sonnet)
    │
    ▼
Ink UI (React for terminal)
    ├── InputBox (bordered, multi-line, autocomplete)
    ├── StreamingOutput (live response rendering)
    ├── ApprovalPrompt (Yes/No for tool actions)
    └── OutputBlock (static log: diffs, tool results, messages)

All AI calls go through claude --print --output-format json, using your authenticated Claude account.

Per-Project Sessions

Each project directory gets isolated sessions:

~/.cliend/projects/<project-hash>/
├── config.json           # Project config overrides
├── memory.md             # Project-level memory
└── sessions/
    └── session-abc123/
        ├── meta.json     # Session metadata + title
        ├── history.jsonl # Conversation log
        ├── memory.md     # Session-specific notes
        └── context/      # Cached ticket/PR/docs

Environment Variables

| Variable | Description | |----------|-------------| | CLIEND_ATLASSIAN_CLIENT_ID | Atlassian OAuth Client ID | | CLIEND_ATLASSIAN_CLIENT_SECRET | Atlassian OAuth Client Secret | | CLIEND_BITBUCKET_USERNAME | Atlassian account email | | CLIEND_BITBUCKET_API_TOKEN | Bitbucket API token | | CLIEND_BITBUCKET_WORKSPACE | Bitbucket workspace slug | | CLIEND_LOG_LEVEL | Logging level: debug, info, warn, error |

Development

git clone [email protected]:sigmacf/cliend.git
cd cliend
npm install
npm run build
node dist/bin/cliend.js   # Run locally
npm run build && cliend   # If installed globally

License

Internal tool. Not for public distribution.