Ariana: Debug your code effortlessly with AI

---

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

🧵 How to use

Follow the Getting started instructions in the Ariana extension panel. Below is a summary of the process:

1) - REQUIRED - Install the ariana CLI

The extension will install the required ariana CLI for you. In case it doesn't:

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

ariana <run command>

For example:

3) 👾 Debug your code

Open the Ariana panel by clicking on the icon in the Activity Bar. Go to the Analyze tab and explore traces produced by Ariana.

• 🗺️ 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

  

4) 🤖 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

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.