Ariana is an IDE extension to understand what happens during runtime. You don't have to put print(), console.log() or breakpoints. Currently supports JS/TS & Python.

✨ Key Features

Use Ariana VSCode extension to :

• 🕵️ Hover over any expression to see its last recorded values
• ⏱️ See how long it took for any expression in your code to run.
• 🧵 Provide runtime history to coding agent for context-aware debugging (WIP)

💾 How to install

1) Install the extension on your IDE

Install the extension on the VSCode Marketplace, or by searching for Ariana in the extensions tab in VSCode or Cursor.

2) Install the ariana CLI

| Package Manager | Command | |-----------------|--------------------------------| | npm | npm install -g ariana | | pip | pip install ariana |

📖 How to use

1) ✨ - REQUIRED - Add ariana just in front of your command. It will collect runtime information

ariana <run command>

For example:

| Codebase Type | Command | |-----------------|----------------------------------------------| | JS/TS | ariana npm run dev | | Python | ariana python myscript.py --some-options-maybe |

2) 👾 View runtime insights directly in your code.

Open a code file, press ctrl + shift + p and search for the Ariana: Toggle Traced Expressions Highlighting command.

• 🗺️ Identify which sections of your code ran

  | Highlight Color | Meaning | |----------------|--------------------------------| | 🟢 Green | Code segment ran successfully. | | 🔴 Red | Code crashed here. | | ⚪ None | Code segment didn’t run or couldn't be recorded. |

• 🕵️ Hover over any expression to reveal its past values

  

3) 🤖 Use AI to recap what your code did & identify error root causes (WIP)

Run:

ariana --recap

It will tell you what might have gone wrong with your code.

Coming soon: A coding agent that answers questions and directly impacts your codebase

Preview :

To test Ariana before using it on your own code:

git clone https://github.com/dedale-dev/node-hello.git
cd node-hello
npm i
ariana npm run start

Troubleshooting / Help

😵‍💫 Ran into an issue? Need help? Shoot us an issue on GitHub or join our Discord community to get help!

Requirements

For JavaScript/TypeScript

• A JS/TS node.js/browser codebase with a package.json
• The ariana command installed with npm install -g ariana (or any other installation method)

For Python

• Some Python >= 3.9 code files (Notebooks not supported yet)
• The ariana command installed with pip install ariana outside of a virtual environment (or any other installation method)

Supported languages/tech

| Language | Platform/Framework | Status | |----------|-------------------|---------| | JavaScript/TypeScript | Node.js | ✅ Supported | | | Bun | ✅ Supported | | | Deno | ⚗️ Might work | | Browser Frameworks | | | | JavaScript/TypeScript | React & .jsx / .tsx | ✅ Supported | | | JQuery/Vanilla JS | ✅ Supported | | | Vue/Svelte/Angular | ❌ Only .js / .ts | | Other Languages | | | | Python | Scripts / Codebases | ✅ Supported | | | Jupyter Notebooks | ❌ Not supported (yet) |

Code processing disclaimer

We process and temporarily store for 48 hours your code files on our server based in EU. It is not sent to any third-party including any LLM provider. An enterprise plan will come later with enterprise-grade security and compliance. If that is important to you, please let us know.

Licence

Code generated and/or transformed by Ariana is yours and not concerned by the following licence and terms.

Ariana is released under AGPLv3. See LICENCE.txt for more details.