agenode

A lightweight AI coding agent for the terminal. Use any LLM provider to assist you while coding.

Installation

npm install -g agenode

Or with pnpm/bun:

pnpm add -g agenode
bun add -g agenode

Requirements: Node.js 18+

Quick Start

# Run the interactive TUI
agenode

# Execute a single command
agenode -e "explain this codebase"

# Continue a previous thread
agenode thread continue <thread-id>

Features

• Multiple Providers — OpenAI, Anthropic, or any OpenAI-compatible API
• MCP Support — Extend with Model Context Protocol servers
• Thread Management — Save and continue conversations
• Permission System — Control tool access (ask/allow/deny)
• Headless Mode — Run single commands with -e

Configuration

On first run, agenode will prompt you to configure a provider. You can also access settings anytime with /config.

Providers

Add your API keys for:

• OpenAI (gpt-4o, gpt-4o-mini, etc.)
• Anthropic (claude-sonnet-4-20250514, claude-3-5-haiku, etc.)
• Custom OpenAI-compatible endpoints

MCP Servers

Add MCP servers for additional capabilities like memory, web search, and more.

Commands

CLI

| Command | Description | |---------|-------------| | agenode | Start interactive TUI | | agenode -e "prompt" | Execute single prompt | | agenode -v, --version | Show version | | agenode -h, --help | Show help | | agenode update | Update to latest version | | agenode thread list | List saved threads | | agenode thread continue <id> | Continue a thread |

In-app

| Command | Description | |---------|-------------| | /help | Show all commands | | /config | Open configuration | | /clear | Start new thread | | /save | Save current thread | | /threads | List saved threads | | /mcp | Show MCP server status | | /permissions | Manage tool permissions | | /exit | Exit and save |

Permissions

Control how agenode handles potentially dangerous operations:

# In-app commands
/permissions                      # View current settings
/permissions set bash allow       # Allow bash without asking
/permissions set write ask        # Ask before writing files
/permissions allow-all            # Trust all operations
/permissions reset                # Reset to defaults

Modes:

• ask — Prompt before executing (default)
• allow — Execute without prompting
• deny — Block the operation

License

MIT

Author

@zt3xdv