🧩 OntoCode Studio
Edit, query, reason over, and visualize OWL/RDF ontologies — collaboratively, right inside VS Code.
A VS Code extension for ontology development, providing a full visual ontology editor through a React-based webview: SPARQL/DL querying, an AI-assisted change review workflow, an OWL reasoner, D3-powered graph visualization, real-time team collaboration, and a plugin marketplace.
Part of the OntoCode Studio platform. Free plan, no credit card needed.


⚡ Get started in 60 seconds
- Install the extension, then click the OntoCode Studio icon in the Activity Bar (the vertical strip of icons on the left edge of VS Code).
- Click Open OntoCode Editor and create an account. The Free plan needs no credit card.
- Create a project or open an ontology file (
.owl, .ttl, .rdf) and start editing.
Want to try it without an account or without VS Code? Use the desktop app, which works offline with no sign-up, or open ontocode.selfresearch.org in your browser.
🚀 Features
- AI Code View assistant — ask questions about your ontology, or let the AI propose edits in Code View (Turtle, RDF/XML, OWL/XML, Manchester, Functional). Review each change before it is applied. Works with your own OpenAI, Gemini or Claude key, or your organization's provider.
- Undo and Redo —
Ctrl+Z to undo and Ctrl+Y or Ctrl+Shift+Z to redo (Cmd+Z and Cmd+Shift+Z on a Mac) reverse creating, deleting and renaming entities, axiom edits and more. In shared projects, Undo only reverses your own changes.
- Ontology editing across formats — the Code View editor reads and writes the same ontology as Turtle, RDF/XML, N-Triples, OWL/XML, Manchester, Functional, or JSON-LD. Switch formats and keep editing — it's not a one-way export.
- SPARQL / DL Query Workbench — run SPARQL queries against your active ontology and browse results as a table or JSON.
- Change Assistant — every edit is tracked as a reviewable change (drafts, saved, conflicts, timeline, rollback) with per-author attribution.
- Built-in reasoner — run HermiT (or other supported reasoners) for consistency checking, satisfiability, and inferred class hierarchies.
- Graph visualization — explore your ontology as an interactive D3 graph (tree, network, and VOWL notation) with AI-generated topic/cluster insights.
- Real-time collaboration — create workspaces, invite members with role-based access, and see collaborator presence live.
- Citation insertion — search your reference library and insert items as inline citations directly in
.owl/.ttl/.rdf/.n3 files from Code View — works the same in VS Code, the web app, and the desktop app.
- Sci2Code editor integration — the
Ctrl+Shift+C / Insert Citation editor command is powered by Sci2Code, inserting a citation at your cursor in any open file (VS Code only).
- Plugin Marketplace — install community and first-party plugins (SWRL Rule Editor, Fuzzy Ontology, additional graph visualizations, and more).
- Desktop app — an Electron-based desktop build for working outside VS Code.
🧭 New to VS Code?
- Install: open the Extensions view (
Ctrl+Shift+X, or Cmd+Shift+X on a Mac), search for OntoCode Studio and click Install.
- Find the icon: it sits in the Activity Bar on the left. If the bar is hidden, choose View → Appearance → Activity Bar.
- Command Palette: press
Ctrl+Shift+P (Cmd+Shift+P on a Mac) and type OntoCode to see every command.
- Open an ontology file: choose File → Open File, pick your
.owl, .ttl or .rdf file, right-click inside it and choose OntoCode: Edit Ontology File. The editor opens as a new tab next to your file.
- Undo and redo:
Ctrl+Z to undo and Ctrl+Y or Ctrl+Shift+Z to redo (Cmd+Z and Cmd+Shift+Z on a Mac) work inside the OntoCode tab. If the change to undo was made in an earlier session, you are asked to confirm first.
- Sign out: run OntoCode: Logout from the Command Palette.
💻 Download the desktop app
Prefer not to use VS Code? The desktop app is the same editor with its own built-in local backend. No VS Code and no setup needed. Downloads are several hundred MB. All options are on the download page.
| Your computer |
Download |
How to install |
| Windows 10 or later (64-bit) |
Windows installer (.exe) |
Run the installer. |
| macOS, Apple silicon (M1 or later) |
macOS disk image (.dmg) |
Open the .dmg and drag OntoCode Studio into Applications. |
| macOS, Intel |
macOS disk image (.dmg) |
Same as above. |
| Linux, any distribution |
AppImage |
chmod +x OntoCode*.AppImage && ./OntoCode*.AppImage |
| Debian or Ubuntu |
.deb package |
sudo apt install ./ontocode-desktop_*_amd64.deb |
| Linux on ARM64 |
AppImage or .deb |
Same as above. |
| Flatpak |
Flatpak package |
Open the downloaded file with your software center, or install it with flatpak. |
🖼 Screenshots
1. Workspace & team collaboration
Create a project, choose who can access it, and invite workspace members by email with role-based permissions.

Read and edit the same ontology as Turtle, RDF/XML, N-Triples, OWL/XML, Manchester, Functional, or JSON-LD syntax — switch formats and keep editing, it's not a one-way export.

3. SPARQL Query Workbench
Write and run SPARQL queries against the active ontology, with results as a sortable table or raw JSON.

4. Change Assistant
Every mutation is tracked as a reviewable, attributable change — with drafts, conflicts, a timeline, and one-click rollback.

5. Built-in OWL reasoner
Run the HermiT reasoner to check consistency, satisfiability, and view the inferred class hierarchy.

6. Citation insertion
Search your reference library and insert a citation directly into the ontology, in whichever format the Code View tab is currently showing. Works identically in VS Code, the web app, and the desktop app.

7. Sci2Code editor integration
A separate, VS Code-only path: run Insert Citation (Ctrl+Shift+C / Cmd+Shift+C) from any open file and it's powered by Sci2Code, OntoCode's companion extension. Pick a reference from your library via the command palette and it's inserted at your cursor, formatted to match the file — OntoCode also detects and offers to fix any RDF namespace declarations the citation needs.

8. Plugin Marketplace
Browse, install, and manage plugins — SWRL rule editing, fuzzy ontology support, alternate graph visualizations, and more.

9. Graph visualization + AI insights
Explore the ontology as an interactive graph (tree, network, or VOWL notation), with AI-generated topic clusters and trend summaries.

Screenshots and GIFs are generated from a real product walkthrough recording — see images/screenshots/ and images/gifs/ for the full set.
🧩 Usage
Starting from scratch (no ontology file open yet):
- Click the OntoCode icon in the Activity Bar.
- Click Open OntoCode Editor at the top of the sidebar.
- Sign in (or create an account) — the editor opens straight into your projects.
Starting from an existing .owl file:
- In the new window, open an
.owl ontology file.
- Right-click the file (or open the Command Palette with
Ctrl+Shift+P / Cmd+Shift+P) and run Edit with OntoCode (ontocode.edit) — or OntoCode: Edit Ontology File (ontocode.editLargeFile) for large files.
- The Ontology Web Editor UI (React webview) will open in a new tab.
- You can now edit and visualize ontology content.
💡 Commands
| Command |
ID |
Description |
| Edit with OntoCode |
ontocode.edit |
Opens the ontology web editor view for an .owl file. |
| OntoCode: Edit Ontology File |
ontocode.editLargeFile |
Opens the editor for large ontology files (streamed/buffered load). |
| OntoCode: Logout |
ontocode.logout |
Signs out of the current OntoCode session. |
| Insert Citation |
ontocode.insertCitation |
Inserts a citation into an .owl/.ttl/.rdf/.n3 file (Ctrl+Shift+C / Cmd+Shift+C). |
| OntoCode: Show Collaboration Status |
ontocode.showCollaborationStatus |
Shows real-time collaboration/presence status. |
| OntoCode: Configure Citation Library |
ontocode.configureZotero |
Sets up the citation library API key/user ID for citation lookup. |
| OntoCode: Test Citation Library Connection |
ontocode.testZoteroConnection |
Verifies the configured citation library credentials. |
| OntoCode: Test Invitation Flow |
ontocode.testInvitationFlow |
Debug command for testing collaboration invite links. |
| Open OntoCode Editor |
ontocode.openWebview |
Opens the OntoCode webview panel directly. |
See contributes.commands in package.json for the authoritative list.
⚙️ Settings
Open Settings and search ontocode:
| Setting |
Default |
Description |
ontocode.zotero.apiKey |
(empty) |
Your citation library API key. |
ontocode.zotero.userId |
(empty) |
Your citation library user ID. |
ontocode.zotero.libraryType |
user |
Type of citation library to read from: user or group. |
ontocode.zotero.groupId |
(empty) |
Group ID, required when libraryType is group. |
See contributes.configuration in package.json for the authoritative list.
🤝 Contributing
To build and run the extension yourself, see Developing the VS Code extension. Contributions are welcome — see the GitHub repository for source, and use Report a bug or Request a feature to tell us what to fix or add.
📄 License
MIT