PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

1.3.5

npm

100xchat

Chat with AI directly from your terminal, with Markdown support.

Published31 Jul 2025
Direct dependencies18
Transitive dependenciesNot calculated

README

Current package documentation

100xchat 🤖

Chat with advanced AI models directly from your terminal.

100xchat is a powerful, fast, and persistent command-line chat client designed for developers. Never leave your terminal to ask a question, generate code, or brainstorm ideas again. Built with Node.js and runnable with a single npx command.

100xchat-demo

✨ Features

  • Zero Installation: Run it instantly from anywhere using npx.
  • Plain Text Streaming: Get raw, unrendered Markdown responses streamed directly to your console.
  • Persistent Sessions: Your conversations are automatically saved. Stop and resume chats anytime.
  • Interactive Menus: Uses fzf (if installed) for a fluid, Telescope-like experience when switching between sessions and models.
  • Graceful Fallback: No fzf? No problem. The tool automatically falls back to a simple, numbered-list interface.
  • Model Switching: Easily switch between the latest OpenAI models (gpt-4o, gpt-4o-mini, etc.) on the fly.
  • Context-Aware: Maintains conversation history to allow for contextual follow-up questions.
  • Private Mode: Quickly start a temporary chat that won't be saved to your history.
  • Smart API Key Handling: Asks for your API key once and securely stores it for future use.
  • Interruptible Responses: Cancel a long, streaming response at any time with Ctrl+C.

🚀 Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • fzf (Optional, but highly recommended for the best interactive experience)

Usage

The beauty of 100xchat is that you don't need to install it. Just run it with npx:

npx 100xchat

The first time you run it, you will be prompted to enter your OpenAI API key. This is saved locally in ~/.100xchat-config.json, so you only have to do it once.

💻 Commands

Control 100xchat using simple slash commands:

CommandDescription
/helpDisplays the list of available commands.
/newStarts a brand new chat session.
/sessionsOpens an interactive menu to switch between your past conversations.
/modelOpens an interactive menu to select a different OpenAI model.
/privateStarts a temporary session that is not saved to your history.
/exitExits the application.
Ctrl+CCancels a streaming response. Press again at the prompt to exit.

🔧 Configuration

  • API Key & Model: Your OpenAI API key and default model are stored in ~/.100xchat-config.json.
  • Sessions: All your conversation histories are stored in ~/.100xchat-sessions.json.

You can safely delete these files to reset the application.

📜 License

This project is licensed under the ISC License. See the package.json file for details.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 18

Native requirements
18 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
@ai-sdk/anthropic
Environment
{
  "local_name": "@ai-sdk/anthropic",
  "alias": false,
  "peer_metadata": null
}
^1.2.12runtime
@ai-sdk/google
Environment
{
  "local_name": "@ai-sdk/google",
  "alias": false,
  "peer_metadata": null
}
^1.2.22runtime
@ai-sdk/openai
Environment
{
  "local_name": "@ai-sdk/openai",
  "alias": false,
  "peer_metadata": null
}
^1.3.23runtime
@mendable/firecrawl-js
Environment
{
  "local_name": "@mendable/firecrawl-js",
  "alias": false,
  "peer_metadata": null
}
^1.29.2runtime
ai
Environment
{
  "local_name": "ai",
  "alias": false,
  "peer_metadata": null
}
^4.3.19runtime
ascii-art
Environment
{
  "local_name": "ascii-art",
  "alias": false,
  "peer_metadata": null
}
^2.8.5runtime
chalk
Environment
{
  "local_name": "chalk",
  "alias": false,
  "peer_metadata": null
}
^4.1.2runtime
commander
Environment
{
  "local_name": "commander",
  "alias": false,
  "peer_metadata": null
}
^14.0.0runtime
diff
Environment
{
  "local_name": "diff",
  "alias": false,
  "peer_metadata": null
}
^8.0.2runtime
dotenv
Environment
{
  "local_name": "dotenv",
  "alias": false,
  "peer_metadata": null
}
^17.2.0runtime
exa-js
Environment
{
  "local_name": "exa-js",
  "alias": false,
  "peer_metadata": null
}
^1.8.23runtime
figlet
Environment
{
  "local_name": "figlet",
  "alias": false,
  "peer_metadata": null
}
^1.8.2runtime
glob
Environment
{
  "local_name": "glob",
  "alias": false,
  "peer_metadata": null
}
^11.0.3runtime
gradient-string
Environment
{
  "local_name": "gradient-string",
  "alias": false,
  "peer_metadata": null
}
^3.0.0runtime
marked
Environment
{
  "local_name": "marked",
  "alias": false,
  "peer_metadata": null
}
^11.2.0runtime
marked-terminal
Environment
{
  "local_name": "marked-terminal",
  "alias": false,
  "peer_metadata": null
}
^6.2.0runtime
pdf-parse
Environment
{
  "local_name": "pdf-parse",
  "alias": false,
  "peer_metadata": null
}
^1.1.1runtime
zod
Environment
{
  "local_name": "zod",
  "alias": false,
  "peer_metadata": null
}
^3.25.76runtime

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "integrity": "sha512-Kcu72WlTbHBwgAiCddK1ERNDANreOl0FHkPSriVbeAOyPTSDMJy5dmv7M1Vhb7g84N6tkhxI8b5bbL2XRbcZ9g==",
  "shasum": "bcad1352c8a17251871592e311a97bce9b1df5c0",
  "tarball": "https://registry.npmjs.org/100xchat/-/100xchat-1.3.5.tgz",
  "fileCount": 16,
  "unpackedSize": 81742,
  "signatures": [
    {
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U",
      "sig": "MEUCIQDuzBc4YzCw8W5pQMjamXPRC2pFyucJCdg9GI3c7jo7DwIgKNLmDZYdtZGhcjqxmWGca/qOUYj8K9WWNVT5G9Bd8RE="
    }
  ]
}

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 17:59 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:e336775fa19925e7bd6904bb89f541475ba0e02678e4d4a8748b7883a8f954b1

Other collected versions

1.3.427 Jul1.3.327 Jul1.3.226 Jul1.3.124 Jul1.3.023 Jul1.2.923 JulView all collected versions →