npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@kyoji2/intercom-cli

v0.1.4

Published

AI-native CLI for Intercom - manage customer conversations, contacts, messages, and support

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

kyoji2kyoji2

Keywords

intercomcustomer-supportconversationscontactscliai-native

Readme

Intercom CLI

AI-native CLI for Intercom - manage customer conversations, contacts, messages, and support.

Installation

From npm (recommended)

bun install -g @kyoji2/intercom-cli

From source

git clone https://github.com/kyoji2/intercom-cli.git
cd intercom-cli
bun install
bun link

Verify installation

intercom --version

Prerequisites

  • Bun runtime (v1.0 or later) - Install Bun
  • Intercom account with API access token

Getting an Access Token

  1. Log in to your Intercom workspace
  2. Navigate to Settings → Developers → Developer Hub
  3. Create a new app or select an existing one
  4. Go to Configure → Authentication
  5. Copy your Access Token

Quick Start

# Authentication
intercom login [token]           # Login with your access token
intercom whoami                  # Show current admin and workspace
intercom logout                  # Remove credentials

# Get context about the account
intercom context                 # Admin info and workspace details
intercom schema                  # Show API schemas (for AI context)

# Manage contacts
intercom contact list            # List contacts
intercom contact search --email "[email protected]"
intercom contact create --email "[email protected]" --name "John Doe"
intercom contact get <id>
intercom contact update <id> --name "New Name"
intercom contact delete <id>

# Manage conversations
intercom conversation list
intercom conversation search --state open
intercom conversation get <id>
intercom conversation reply <id> --admin <admin-id> --body "Thank you!"
intercom conversation close <id> --admin <admin-id>

# Manage companies
intercom company create --company-id "acme" --name "Acme Corp"
intercom company list
intercom company get <id>

# Manage tags
intercom tag list
intercom tag create "VIP Customer"

# Help center articles
intercom article list
intercom article search "getting started"
intercom article get <id>

# Track events
intercom event track --name "purchase" --user-id "user123"

# Manage tickets
intercom ticket create --type-id 1234 --contact-id abc123 --title "Issue"
intercom ticket search --state open
intercom ticket get <id>
intercom ticket reply <id> --admin <admin-id> --body "We're on it!"
intercom ticket close <id> --admin <admin-id>

# List ticket types
intercom ticket-type list

Commands

Authentication

| Command | Description | |---------|-------------| | intercom login [token] | Save access token (prompts if not provided) | | intercom logout | Remove stored credentials | | intercom whoami | Show current admin and workspace info | | intercom context | Show account context (admins, workspace) | | intercom schema | Output API schemas for AI context |

Contacts

| Command | Description | |---------|-------------| | intercom contact create | Create a new contact | | intercom contact get <id> | Get contact details | | intercom contact update <id> | Update a contact | | intercom contact delete <id> | Delete a contact | | intercom contact search | Search contacts | | intercom contact list | List contacts | | intercom contact note <id> <body> | Add note to contact | | intercom contact notes <id> | List contact notes | | intercom contact tag <id> <tag-id> | Tag a contact | | intercom contact untag <id> <tag-id> | Remove tag from contact | | intercom contact attach-company <id> <company-id> | Attach contact to company |

Conversations

| Command | Description | |---------|-------------| | intercom conversation list | List conversations | | intercom conversation get <id> | Get conversation details | | intercom conversation search | Search conversations | | intercom conversation reply <id> | Reply to conversation | | intercom conversation assign <id> | Assign conversation | | intercom conversation close <id> | Close conversation | | intercom conversation open <id> | Reopen conversation | | intercom conversation snooze <id> | Snooze conversation | | intercom conversation convert <id> | Convert conversation to ticket |

Companies

| Command | Description | |---------|-------------| | intercom company create | Create a company | | intercom company get <id> | Get company details | | intercom company list | List companies | | intercom company update <id> | Update a company |

Tags

| Command | Description | |---------|-------------| | intercom tag list | List all tags | | intercom tag create <name> | Create a tag | | intercom tag get <id> | Get tag details | | intercom tag delete <id> | Delete a tag |

Articles

| Command | Description | |---------|-------------| | intercom article list | List articles | | intercom article get <id> | Get article details | | intercom article search <query> | Search articles | | intercom article create | Create an article | | intercom article update <id> | Update an article | | intercom article delete <id> | Delete an article |

Admins

| Command | Description | |---------|-------------| | intercom admin list | List all admins | | intercom admin get <id> | Get admin details |

Events

| Command | Description | |---------|-------------| | intercom event track | Track a custom event | | intercom event list | List events for a user |

Tickets

| Command | Description | |---------|-------------| | intercom ticket create | Create a new ticket | | intercom ticket get <id> | Get ticket details | | intercom ticket update <id> | Update a ticket | | intercom ticket delete <id> | Delete a ticket | | intercom ticket search | Search tickets | | intercom ticket reply <id> | Reply to a ticket | | intercom ticket close <id> | Close a ticket | | intercom ticket assign <id> | Assign ticket to admin/team |

Ticket Types

| Command | Description | |---------|-------------| | intercom ticket-type list | List all ticket types | | intercom ticket-type get <id> | Get ticket type details |

Global Options

All commands support:

--dry-run              # Log actions without making API calls
-f, --format <format>  # Output format: toon (default) or json
--config-dir <path>    # Config directory (default: ~/.config/intercom-cli)
-v, --version          # Show version
-h, --help             # Show help

Output Formats

TOON (Default)

Token-optimized format designed for AI agents:

field_name: value
another_field: value

JSON

Standard JSON output with --format json:

{
  "field_name": "value"
}

Environment Variables

| Variable | Description | |----------|-------------| | INTERCOM_ACCESS_TOKEN | Access token (takes priority over config file) |

Configuration

Credentials are stored in ~/.config/intercom-cli/config.json

Development

# Run in development mode
bun run dev

# Run tests
bun test

# Lint code
bun run lint

# Format code
bun run format

# Type check
bun run typecheck

# Build
bun run build

License

MIT