@plastichub/code-bot

AI-powered command-line tool for code modifications and project management that supports multiple AI models and routers.

Overview

Code-bot is a powerful CLI tool that helps developers automate code modifications, handle project management tasks, and integrate with various AI models for intelligent code and content assistance.

Key Features

AI Model Integration

• OpenAI Support: Full integration with OpenAI GPT models
• OpenRouter Support: Access to additional AI models through OpenRouter
• Anthropic Claude Models: Support for Claude-3 series models
• Flexible Model Selection: Switch between models using command line options

Project Management

• Smart Code Modifications: Automated code updates and refactoring
• Template System: Built-in and custom template support with path definitions
• File Operations: Intelligent file handling and modifications
• Git Integration: Automated git operations and commit management

Project Templates

Available templates defined in TemplateDefinitionSchema:

• Built-in templates:
  • typescript: TypeScript project templates
  • react: React application templates
  • hugo: Hugo static site templates
  • node-api: Node.js API project templates
• Custom template paths: Support for custom template definitions

Logging & History

Logs and session history are stored in the .kbot directory within your project:

• messages.json: Complete conversation history with AI, including:
  • Session IDs and timestamps
  • User queries
  • AI responses
  • Tool execution details
• modify-files.json: List of modified project files
• stats.json: Usage statistics and token consumption
• tools.json: Record of tool operations
• history.json: Comprehensive modification history
• openai.md: Markdown formatted log of commands and responses

View modification history using:

kbot log .

Quick Start

NPM Installation

npm install -g @plastichub/code-bot

Configuration

API Keys Setup

Create configuration at $HOME/.osr/.config.json (or export OSR_CONFIG):

{
  "openrouter": {
    "key": "your-openrouter-key"
  },
  "openai": {
    "key": "your-openai-key"
  }
}

Basic Usage

• See ./tests/ts-cli-modify.sh for more examples

Project Modification

File Selection

kbot modify . --glob "src/**/*.ts" --glob "Readme.md" --query="Update API and command documentation" --template=typescript

View History

# View modification history
kbot log .

Advanced Configuration

Command Options

# AI Model Selection
kbot modify . --model anthropic/claude-3-opus

# Custom Output Path
kbot modify . --output ./modified

# Tool Control
kbot modify . --disable=fs --disable=npm --disable=git --disable=interact --disable=user

# Router Selection
kbot modify . --router openai

Development

# Install Dependencies
pnpm install

# Development Mode
pnpm dev

# Build Project
pnpm build