Editor Window

Every view you open in WSO2 Agent Builder (Project view, Integration view, Library view, and so on) renders inside the same window with a top menu bar, an activity bar on the far-left edge, an editor tab area with editor toolbar, and the side panels for the project explorer and deployment options. This page describes the parts of that window that stay the same across views, so the view-specific pages do not need to repeat them.

Top menu bar

The top menu bar runs across the top edge of the application window and groups the standard application menus.

Menu	Description
WSO2 Agent Builder	Application-level actions such as About, Preferences, and Quit.
File	Open, save, and close projects, files, and windows.
Edit	Standard editing actions such as undo, redo, cut, copy, paste, and find.
Selection	Selection and multi-cursor actions for the source editor.
View	Toggle the activity bar, side bar, panel, terminal, and other layout elements.
Go	Navigation actions such as Go to File, Go to Definition, and Go to Symbol.
Run	Run and debug actions for the active integration.
Terminal	Open and manage integrated terminals.
Window	Manage open windows.
Help	Documentation, release notes, and support links.

The top menu bar covers general application actions. Agent Builder-specific actions live in the activity bar and the editor toolbar.

Activity bar

The activity bar is the narrow vertical strip on the far-left edge of the editor. Each icon opens a different panel or tool, and the active icon is highlighted.

Name	Description
WSO2 Agent Builder	Opens the project explorer for the current view. This is the main entry point back to your project.
Explorer	Opens the file explorer to browse the raw project files on disk, such as .bal source files and .toml configuration files.
Source Control	Opens the Git source control panel for staging, committing, and reviewing changes.
Run and Debug	Opens the debug panel for setting breakpoints, launching the agentic integration with the debugger, and inspecting variables.
Testing	Opens the test explorer to view, run, and debug the test cases defined for your agentic integration.
Accounts	Shows the signed-in WSO2 Agent Builder account and provides actions to manage extension account preferences and language model access.
Manage	Opens the editor management menu with access to the Command Palette, Profiles, Settings, Keyboard Shortcuts, Snippets, Tasks, and Themes.

Select the WSO2 Agent Builder icon at any time to return to the project explorer and the current view.

Project explorer

The project explorer is the left sidebar that organizes the contents of your project into a structured tree.

• At the project level, the project explorer lists all agentic integrations and libraries in the project, grouped by name. Each entry is expandable to reveal its own artifact tree.
• Inside an agentic integration or library, the project explorer organizes its components into sections by artifact type, making it easy to locate and manage the building blocks of your agents.

When an agentic integration or library is open, the project explorer groups its artifacts into the following sections. Select an artifact name to open it in its dedicated view, or select the + icon next to a section to add a new one.

Section	What it shows
Agents	The AI agents defined in the agentic integration or library.
Entry Points	The triggers and services that call your agents, such as an Agent Chat endpoint. Libraries have no entry points. To add one, select Add Trigger on an agent card in the Integration view.
Model Providers	Connections to the LLMs your agents use.
Connections	Configured links to external systems such as databases, HTTP APIs, and message brokers.
Types	Custom records, enums, arrays, service classes, and unions used in your agentic integration.
Functions	Reusable logic blocks, such as agent tools, callable from agents, entry points, or other functions.
Configurations	Variables sourced from Config.toml at runtime.

For details on each artifact type, see Integration artifacts.

Editor tab area

The editor tab area sits above the canvas and shows one tab per open editor. The active tab is highlighted, and you can close a tab with the × action on it.

The WSO2 Agent Builder tab represents the visual designer for the current view. Other tabs, such as a Ballerina source file opened from the explorer, appear alongside it.

Editor toolbar

The editor toolbar appears on the right side of the editor tab bar and provides quick actions for the active agentic integration.

Action	Description
Open Copilot	Opens the WSO2 Agent Builder Copilot chat panel for AI-powered assistance with building and troubleshooting your agents.
Run	Builds and runs the agentic integration locally, starting all services and streaming output to the terminal.
Debug	Launches the agentic integration with the debugger attached so you can set breakpoints and inspect variables.
Show Source	Switches the editor from the visual designer to the Ballerina source for the current artifact.
Split editor	Opens the active editor in a second column so you can view two surfaces side by side.
More (⋯)	Reveals additional editor actions, such as reopening recently closed editors and pinning the tab.

The available actions depend on what is open. Open Copilot appears in the Project view, and Show Source appears when an artifact such as a function is open.

Status bar

The status bar runs across the bottom edge of the editor and shows the current state of your project, runtime, and tooling at a glance. Select an item to open the related panel or action.

Item	Description
Branch indicator (for example, main*)	Shows the active Git branch when the project is a Git repository. An asterisk indicates uncommitted changes. Select it to switch or manage branches.
Problems (error and warning counts)	Shows the number of errors and warnings detected in the current project. Select it to open the Problems panel.
Ballerina version	Shows the Ballerina distribution version that the editor is using to build and run your agentic integration (for example, Ballerina 2201.14.1 (Swan Lake Update 14)).
ICP	Shows the status of the local Integration Control Plane server (for example, ICP: Stopped). Select it to start the server.
Notifications	Opens the notifications panel for messages from the editor and its extensions.

What's next

• Project view — Work with multiple agentic integrations and libraries.
• Integration view — Build and manage a single agentic integration.
• Library view — Build reusable libraries.