The concept editor opens when you click a concept in the Explorer or lineage canvas, or when you create a new cell. It’s where you write a concept’s logic, run it, and inspect the result. The editor has three parts: a toolbar at the top, a row of tabs (logic, description, engine, output), and the code area below.
The concept editor

Toolbar

The concept editor toolbar
The left side of the toolbar defines what the concept is:
ControlWhat it does
Concept name (dropdown)Selects which predicate this concept outputs. It auto-tracks the last predicate parsed from your code until you pick one explicitly, which then locks it in.
Rename (pencil)Renames the concept. Available once the concept has been saved.
Type (dropdown)Sets the language: Logic (Vadalog), SQL, Cypher, or Python.
APICopies a ready-to-run cURL command for this concept’s REST run endpoint, using a fresh, short-lived API key (your session token is never embedded). Paste it into a terminal to run the concept from outside the app. See the Concepts API.
GroupAdds the concept to a group (folder), or removes it from its current group.
The right side of the toolbar holds the actions:
ControlTooltipWhat it does
LinkData bindingsOpens the bind editor to map input/output predicates to data sources.
GearSettingsOpens cell settings, including evaluation policies.
Run ▸Run cell / Run workflowRuns the concept. The dropdown chooses Run cell (this concept only) or Run workflow (this concept plus everything it depends on). Shortcut: Shift+Enter.
StopStop executionReplaces Run while the concept is executing; cancels the run.
XClear resultsClears the displayed output.
UndoRestore resultsBrings back the last cleared output.
SaveSave cellSaves the concept (⌘S / Ctrl+S). Turns blue with a Modified label when there are unsaved changes.
TrashDelete cellPermanently deletes the concept (asks for confirmation).

Tabs

TabWhat it shows
logicThe code editor — your Vadalog (or SQL / Cypher / Python), with syntax highlighting and line numbers.
descriptionA plain-English description of the concept. You can tag other concepts with @name. Two helpers sit below the text: Generate description from code (writes a description for you) and ✨ Generate Vadalog from natural language (drafts the code from your description).
engineA live engine monitor showing compute/execution status while the concept runs.
outputThe result table(s): paginated rows with search and per-column filters, plus row counts and run timings.
The output tab carries a status dot:
DotMeaning
GreenResults are available (success).
Blue (pulsing)The concept is currently running.
RedThe last run errored.
YellowThe run was stopped by the user.

Editor controls

To the right of the tab row:
ControlTooltipWhat it does
(i)Editor keyboard shortcutsShows the full keyboard-shortcut reference.
IndentAuto indent codeReformats and re-indents the code (⌘I / Ctrl+I).
WrapToggle word wrapSwitches long lines between wrapping and horizontal scrolling.
Ask AIOpen AI assistant for this conceptOpens the AI Assistant focused on this concept. Available once the concept is saved.

Keyboard shortcuts

The editor’s own shortcuts (shown as Mac / Windows·Linux):
ActionShortcut
RunShift+Enter
Save⌘S / Ctrl+S
Auto-indent⌘I / Ctrl+I
Toggle comment⌘7 / Ctrl+7
Toggle word wrap⌘⌥Z / Alt+Z
Standard code-editor shortcuts also work:
ActionShortcut
Select next occurrence⌘D / Ctrl+D
Select all occurrences⌘⇧L / Ctrl+Shift+L
Add cursor above / below⌘⌥↑ / ⌘⌥↓ (Mac), Ctrl+Alt+↑ / (Win/Linux)
Move line up / downAlt+↑ / Alt+↓
Copy line up / downShift+Alt+↑ / Shift+Alt+↓
Find / Replace⌘F / Ctrl+F
Find next / previous⌘G / ⌘⇧G (Mac), Ctrl+G / Ctrl+Shift+G (Win/Linux)
Go to line⌘⌥G / Ctrl+Alt+G
Don’t write Vadalog by hand if you’d rather not: write what you want in the description tab and use ✨ Generate Vadalog from natural language, or open Ask AI to have the assistant write and run the concept for you.

Where to go next

Project Workspace

The Explorer, the Concepts and Data tabs, and the lineage canvas around the editor.

Concepts & Lineage

What concepts are and how lineage is captured.

Vadalog Reference

The language you write in the logic tab.

Concepts API

Run concepts and read results over REST (what the API button generates).