jchat

JChat - Chat to your AI with an interactive TUI.

A TUI for interacting with AI agents configured via JSON files.

• Attach MCP tools (text-tools only)
• Create sub agents recursively

Usage

jchat [flags]

Configuration Files

Configuration files are created on first boot, and can be found at ~/jchat/.

agent.json

Configure the agent's model and MCP servers:

{
    "agent_name": "josh's agent",
    "agent_description": ["a general purpose high-level agent"],
    "model_name": "gpt-4.1",
    "mcp_servers": [
        {
            "addr": "http://localhost:1234/mcp",
            "headers": {
                "Authorization": "Bearer your-token"
            }
        }
    ],
    "sub_agents": [
        <recursive>
    ]
}

models.json

Define available models:

{
    "models": {
        "gpt-4.1": {
            "url": "https://api.example.com/v1/chat/completions",
            "name": "gpt-4.1",
            "key": "your-api-key"
        }
    }
}