Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ariana) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

IDE	Command
VSCode	Click here to install
Cursor / Windsurf (VSCode Forks)	Download from open-vsix then drag the `.vsix` file into your extensions panel in Cursor/Windsurf...

🧵 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:

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

2) ✨ - 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`

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

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

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

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.

ariana