README.md

ComputerUseAgent

A sophisticated Deno-based CLI tool that provides AI-powered file editing and bash command execution capabilities using Claude 3 API.

Features

• Dual Mode Operation:
  • Editor mode for AI-assisted text file manipulation
  • Bash mode for intelligent command execution
  • Hybrid mode for combined capabilities
• Enhanced Export System:
  • Prompt ID-based export functionality
  • Dedicated export paths
  • Rich session data export
  • Comprehensive session logging
• Improved User Management:
  • Streamlined settings management
  • Enhanced session handling
  • Efficient tool configuration
• Memory Management
• Comprehensive Logging
  • Text response content tracking
  • Debug logging for history entries
  • Token usage tracking
• Cost Calculation
• History Management with database integration
• Clipboard Management with cross-platform support
• Tool Configuration Management
• User Settings Management
• Jina API Integration for enhanced search capabilities

Demo

ComputerUseDemo.mp4

This is a trimmed demo, Watch full demo on Youtube

Prerequisites

• Deno installed
• Anthropic API Key

Setup

1. Clone the repository:

git clone <repository-url>
cd ComputerUseAgent

2. Set up your environment:

# Set your Anthropic API key
export ANTHROPIC_API_KEY="your-api-key"

3. Build the project:

deno task build

Usage

Direct Execution

# Editor mode
deno run -A src/main.ts --mode=editor "your prompt"

# Bash mode
deno run -A src/main.ts --mode=bash "your command"

# Bash mode with mock execution
deno run -A src/main.ts --mode=bash --no-agi "your command"

Using Built Binary

# After building
./build/ComputerUseAgent --mode=editor "your prompt"
./build/ComputerUseAgent --mode=bash "your command"
./build/ComputerUseAgent --export "prompt-id" # Export session data

Project Structure

• src/: Source code directory
  • config/: Configuration files
  • modules/: Core functionality modules
    • bash/: Bash command execution
    • editor/: Text editor operations
    • memory/: Memory management
  • types/: TypeScript interfaces
  • utils/: Utility functions

Configuration

Key configuration files:

• src/config/constants.ts: System-wide constants and API settings
• src/config/logging.ts: Logging configuration
• src/config/tool_config.ts: Tool configuration
• deno.json: Deno project configuration

Documentation

• See CHANGELOG.md for detailed version history and latest changes
• Key configuration files:
  • src/config/constants.ts: System-wide constants and API settings
  • src/config/logging.ts: Logging configuration
  • src/config/tool_config.ts: Tool configuration
  • deno.json: Deno project configuration

Development

# Run in development mode with file watching
deno task dev

# Build for local use
deno task buildLocal

Logging

Logs are stored in app.log with both console and file output. The logging system tracks:

• User inputs
• API usage
• Command execution
• Errors
• Token usage and costs

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

License

See LICENSE file.

Releases

Installation

You can download pre-built binaries for your platform from:

• Latest stable release: Releases page
• Nightly builds: Nightly Release

Binaries are automatically built for Windows, Linux, and macOS.