PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

1.1.7

npm

100xchat

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

Published21 Jul 2025
Direct dependencies9
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 9

Native requirements
9 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
ai
Environment
{
  "local_name": "ai",
  "alias": false,
  "peer_metadata": null
}
^4.3.19runtime
zod
Environment
{
  "local_name": "zod",
  "alias": false,
  "peer_metadata": null
}
^4.0.5runtime
diff
Environment
{
  "local_name": "diff",
  "alias": false,
  "peer_metadata": null
}
^8.0.2runtime
glob
Environment
{
  "local_name": "glob",
  "alias": false,
  "peer_metadata": null
}
^11.0.3runtime
marked
Environment
{
  "local_name": "marked",
  "alias": false,
  "peer_metadata": null
}
^12.0.2runtime
openai
Environment
{
  "local_name": "openai",
  "alias": false,
  "peer_metadata": null
}
^4.0.0runtime
@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
marked-terminal
Environment
{
  "local_name": "marked-terminal",
  "alias": false,
  "peer_metadata": null
}
^6.2.0runtime

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "bcd8df44912c109a04628bec310a93fa91b39023",
  "tarball": "https://registry.npmjs.org/100xchat/-/100xchat-1.1.7.tgz",
  "fileCount": 11,
  "integrity": "sha512-g4CDrbWOXwlUCW7G9vcXFnm2txat7pJGEgHfZ526cP4OL1PegPVL09tv5t/xyximy8XsokdcoMQJdQg5ppEk2w==",
  "signatures": [
    {
      "sig": "MEYCIQDZHyKt4bSGHeaIjMWV2QZRVxf3EP5j2uLft7R9Fo4d/wIhAKVQq9LHrW/W+y4Kc9u8HXKXXz5zCJJu5P7gzub5SNc2",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 51337
}

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:e48811d323f3c54004a82305106a5f2cd8ac3c55e7bddddbc2b75fb891cae87b

Other collected versions

1.3.531 Jul1.3.427 Jul1.3.327 Jul1.3.226 Jul1.3.124 Jul1.3.023 JulView all collected versions →