Introduction

What is CodeBanana Bot

Unlike the web version, CodeBanana Bot operates within your local environment, allowing the agent to interact with your files, applications, browser, and system, extending AI capabilities beyond the cloud into your personal workspace.

Web vs CodeBanana Bot

CodeBanana Bot and the Web version are two forms of the same product, sharing the same account system and synchronized data.

Dimension	Web	CBBot
Runtime	Browser-based	Local desktop application
Core features	Full product capabilities (projects, chats, orgs)	Same core capabilities
Agent scope	Cloud projects & environments	Local system, files, apps, browser
Account	Shared	Shared
Project visibility	Cloud + local (when client is online)	Cloud + local
Best for	Collaboration & accessibility	Deep local automation

Both interfaces display the same project list. Cloud projects are always accessible, while local projects are available when the client is online.

Installation

CodeBanana Bot supports both macOS and Windows.

Platform	Support
macOS	✅
Windows	✅

Steps

Download the installer from the CodeBanana website
Install:
- macOS: Open .dmg and drag to Applications
- Windows: Run .exe installer
Launch CodeBanana Bot and log in with your account

Account

Use the same CodeBanana account as Web
Supports email and third-party login
Can stay logged in on both Web and CBBot

Data Sync

Data	Behavior
Account info	Synced in real time
Billing & Plan	Shared across platforms
Organization	Shared members & permissions
Team Plan	Fully synced
Cloud projects	Fully synced
Local projects	Synced; shown as offline if client is offline
Chat history	Synced across devices

Project configurations (Basic Info, Skills, Cron Jobs) are project-specific but consistent across platforms.

Local Agent Capabilities

CodeBanana Bot enables agents to operate directly on your local machine.

System Control

Read, create, modify, delete files
Move and batch process files
Execute terminal commands and scripts
Access system-level information

Application Control

Open local applications
Simulate user interactions (click, type, etc.)

Browser Automation

Navigate web pages
Fill forms and extract data
Simulate full browsing workflows

Screen Understanding

Capture screen content
Analyze UI states
Validate operation results

Typical Use Cases

Scenario	Workflow
File organization	Scan → classify → move files
Form automation	Open browser → fill → submit
Reporting	Capture screen → analyze → generate report
File monitoring	Trigger workflows via File Watch
App automation	Open app → execute actions

Bot-only Features

Bot-exclusive Skills

CodeBanana Bot supports Bot-only Skills, which include local system operations.

Type	Availability
Standard Skills	Web + Bot
Bot-only Skills	Bot only (`Bot` tag)

Cron Job Differences

Capability	Web	CBBot
Scheduled tasks	✅	✅
System notifications	❌	✅
File Watch scope	Project files only	Full local filesystem

Project Status

Type	Location	Availability
Cloud Project	Server	Always available
Local Project	Local machine	Offline when client is offline

Projects
├── Cloud Project A (always available)
├── Cloud Project B (always available)
├── Local Project C (online available)
└── Local Project D (online available)

Permissions

Permission setup differs by system. Path: CBBot → Settings → Permissions

Setting	Required	Description	macOS	Windows
Keep Awake	Optional	Keeps the system active when the lid is closed or the screen is off (requires power connection)	✅ Supported	✅ Supported
Accessibility	Recommended	Enables UI automation, including controlling system interfaces and simulating keyboard/mouse input	✅ Manual permission required	— Not required
Full Disk Access	Recommended	Allows reading and writing files across the entire system	✅ Manual permission required	— Not required
Screen Recording	Optional	Enables screen capture and recording (including system audio)	✅ Manual permission required	— Not required

Accessibility and Full Disk Access are critical for core functionality. Some changes require restarting the app.

Getting started

Working in CodeBanana

CodeBanana Bot

Account and subscriptions

Teams

What is CodeBanana Bot

Web vs CodeBanana Bot

Installation

Steps

Account

Data Sync

Local Agent Capabilities

System Control

Application Control

Browser Automation

Screen Understanding

Typical Use Cases

Bot-only Features

Bot-exclusive Skills

Cron Job Differences

Project Status

Permissions

​What is CodeBanana Bot

​Web vs CodeBanana Bot

​Installation

​Steps

​Login & Sync

​Account

​Data Sync

​Local Agent Capabilities

​System Control

​Application Control

​Browser Automation

​Screen Understanding

​Typical Use Cases

​Bot-only Features

​Bot-exclusive Skills

​Cron Job Differences

​Project Status

​Permissions

What is CodeBanana Bot

Web vs CodeBanana Bot

Installation

Steps

Login & Sync

Account

Data Sync

Local Agent Capabilities

System Control

Application Control

Browser Automation

Screen Understanding

Typical Use Cases

Bot-only Features

Bot-exclusive Skills

Cron Job Differences

Project Status

Permissions