ifcli

Chat with AI via CLI.

Features:

• System prompt settings and management.
• Support preset message settings.
• History chat record management and viewing.
• MCP(tools) Supported.
• Supports diverse gameplay with alias.

Install

ifcli is built by bunjs and requires a bun environment.

From NPM

npm install -g @vhxnif/ifcli

From Source Code

bun install && bun run build && bun link

Config

To configure various application settings using the ifct -s command.Please configure the large model settings before use.

To use MCP Server, you must first configure the relevant information and enable MCP functionality for the current chat session ifct cf -p.

The EDITOR environment variable must be configured to enable configuration editing and related system functions.If not configured, vim will be used as the default editor.

Data Path

Windows: Data and MCP configurations are stored in %APPDATA%\ifcli.

macOS/Linux: They are located in $HOME/.config/ifcli.

Every release includes a version-specific data file (ifcli_<version>.sqlite). You will need to handle data migration separately.

Command

Usage: ifct [options] [command]

ifcli chat with LLM

Options:
  -V, --version           output the version number
  -s, --setting           ifcli setting edit
  -h, --help              display help for command

Commands:
  new <string>            new chat
  ask [options] [string]  chat with AI
  list|ls                 list all chats
  history|hs [options]    view chat history
  remove|rm               remove chat
  switch|st               switch to another chat
  prompt|pt [options]     prompt manager
  preset|ps [options]     preset message manager
  config|cf [options]     manage chat config
  clear|cl                clear the current chat message

AppSetting

{
  "generalSetting": {
    "interactive": true // Turn this off if Bash shows display errors. On Nushell (Windows), you must disable it.
  },
  "mcpServers": [
    {
      "name": "weather",
      "version": "v1",
      "type": "sse",
      "url": "http://localhost:3000/sse"
    },
    {
      "name": "weather",
      "version": "v2",
      "type": "stdio",
      "params": {
        "command": "bun",
        "args": [
          "run",
          "/Users/chen/workspace/weather-mcp/src/mcp/stdio-server.ts"
        ]
      }
    }
  ],
  "llmSettings": [
    {
      "name": "deepseek",
      "baseUrl": "https://api.deepseek.com",
      "apiKey": "<your deepseek api key>",
      "models": [
        "deepseek-chat",
        "deepseek-reasoner"
      ]
    },
    {
      "name": "ollama",
      "baseUrl": "http://localhost:11434/v1/",
      "apiKey": "",
      "models": [
        "gemma3:latest"
      ]
    },
    {
      "name": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "<your openai key>",
      "models": [
        "gpt-4o"
      ]
    }
  ]
}

General Setting

column name	type	required
interactive	boolean	true

LLM Setting

column name	type	required
name	string	true
baseUrl	string	true
apiKey	string	false
models	string[]	true

MCP Server(SSE)

column name	type	required
name	string	true
version	string	true
type	'sse'	true
url	string	true
opts	SSEClientTransportOptions	false

MCP Server(Stdio)

column name	type	required
name	string	true
version	string	true
type	'stdio'	true
params	StdioServerParameters	true

Tips

Chat without ifct switch

# the `ts` is another chat that supports translation.
alias ts = ifct ask -c 'ts'

Edit System Prompt

Pipe symbols are supported

cat system_prompt.md | ifct pt -c

Use the editor

ifct pt -m