JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 19
  • Score
    100M100P100Q88813F
  • License MIT

AI Agent that can be started from a remote configuration URL

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@jack230230/agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @zhenwei/agent

    AI Agent that can be started from a remote configuration URL. This package allows you to quickly spin up an AI agent using Claude or OpenAI, configured through a centralized dashboard.

    Quick Start

    Start an agent using npx (no installation required):

    npx -y @zhenwei/agent https://your-dashboard.com/api/ac/your-token

    Features

    • 🤖 Support for Claude (Anthropic) and OpenAI providers
    • 🔌 Model Context Protocol (MCP) support
    • 🔧 Built-in tools: file operations, shell operations, web automation, and more
    • 📝 Memory management
    • ⏰ Scheduled tasks
    • 🌐 Remote configuration via API

    Prerequisites

    Required Environment Variables

    Depending on which AI provider you're using, you'll need one of these API keys:

    # For Claude (Anthropic)
export ANTHROPIC_API_KEY="your-api-key"

# For OpenAI
export OPENAI_API_KEY="your-api-key"

    Optional Environment Variables

    For Mac automation features:

    export UITARS_URL="http://localhost:8083"  # Default
export CUA_PROVIDER="uitars"               # Default

    Usage

    The easiest way to start an agent is using npx with a config URL from your dashboard:

    npx -y @zhenwei/agent https://localhost:3001/api/ac/token_abc123

    The config URL should be in the format: https://your-dashboard/api/ac/<token>

    Using the CLI after installation

    # Install globally
npm install -g @zhenwei/agent

# Run
agent https://your-dashboard.com/api/ac/your-token

    Configuration

    The agent configuration is fetched from the provided URL and includes:

    • Agent name and provider (Claude/OpenAI)
    • System prompt
    • Enabled tools (file operations, shell, web, etc.)
    • MCP server configurations
    • Provider-specific settings (model, temperature, etc.)
    • Authentication credentials for dashboard connection

    Development

    Local Development

    # Clone the repository
git clone https://github.com/zhenwei/Jessica.git
cd Jessica/apps/agent

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

    Building

    pnpm build

    Publishing

    # From the root of the workspace
pnpm publish:agent

    Architecture

    This agent connects to a dashboard via WebSocket to receive commands and report status. It supports:

    • Multiple AI Providers: Claude (Anthropic) and OpenAI
    • MCP (Model Context Protocol): Connect to various MCP servers for extended capabilities
    • Built-in Tools: File operations, shell commands, web automation, task management
    • Remote Configuration: Fetch configuration from a centralized dashboard
    • Real-time Communication: WebSocket connection for bi-directional communication

    License

    MIT

    Author

    Zhenwei

    Repository

    https://github.com/zhenwei/Jessica