rowboat/README.md

RowboatX - Claude Code for Everyday Automations

• ✨ Create background agents with full shell access
  • E.g. "Generate a NotebookLM-style podcast from my saved articles every morning"
• 🔧 Connect any MCP server to add capabilities
  • Add MCP servers and RowboatX handles the integration
• 🎯 Let RowboatX control and monitor your background agents
  • Easily inspect state on the filesystem

Inspired by Claude Code, RowboatX brings the same shell-native power to background automations.

Quick start

npx @rowboatlabs/rowboatx@latest

Demo

Examples

Add and Manage MCP servers

$ rowboatx

• Add MCP: 'Add this MCP server config: <config> '
• Explore tools: 'What tools are there in <server-name> '

Create background agents

$ rowboatx

• 'Create agent to do X.'
• '... Attach the correct tools from <mcp-server-name> to the agent'
• '... Allow the agent to run shell commands including ffmpeg'

Schedule and monitor agents

$ rowboatx

• 'Make agent <background-agent-name> run every day at 10 AM'
• 'What agents do I have scheduled to run and at what times'
• 'When was <background-agent-name> last run'
• 'Are any agents waiting for my input or confirmation'

Run background agents manually

rowboatx --agent=<agent-name> --input="xyz" --no-interactive=true

rowboatx --agent=<agent-name> --run_id=<run_id> # resume from a previous run

Models support

You can configure your models using:

rowboatx model-config

Alternatively, you can directly edit ~/.rowboat/config/models.json

{
  "providers": {
    "openai": {
      "flavor": "openai"
    },
    "lm-studio": {
      "flavor": "openai-compatible",
      "baseURL": "http://localhost:2000/...",
      "apiKey": "...",
      "headers": {
        "foo": "bar"
      }
    },
    "anthropic": {
      "flavor": "anthropic"
    },
    "google": {
      "flavor": "google"
    },
    "ollama": {
      "flavor": "ollama"
    }
  },
  "defaults": {
    "provider": "lm-studio",
    "model": "gpt-5"
  }
}

---

Rowboat Studio - Cursor for Multi-agent Workflows

⚡ Build AI agents instantly with natural language | 🔌 Connect tools with one-click integrations | 📂 Power with knowledge by adding documents for RAG | 🔄 Automate workflows by setting up triggers and actions | 🚀 Deploy anywhere via API or SDK

Quick start

1. Set your OpenAI key

   export OPENAI_API_KEY=your-openai-api-key  
   

2. Clone the repository and start Rowboat (requires Docker)

   git clone git@github.com:rowboatlabs/rowboat.git
   cd rowboat
   ./start.sh
   

3. Access the app at http://localhost:3000.

To add tools, RAG, more LLMs, and triggers checkout the Advanced section below.

Create a multi-agent assistant with MCP tools by chatting with Rowboat

---

Contributing

We'd love your help making Rowboat better! Join our 💬 Discord