Interactive Mode

Docs › Core Features › Interactive Mode

Interactive Mode

Run nova in a project folder to open an interactive session. You chat with NOVA, watch it work, approve what it wants to do, and use commands to steer.

Start a session

bash
cd my-project
nova

NOVA works in the folder you start it in.

Requests and commands

Anything that starts with a backslash is a command. Everything else is a request:

\status ← a command
Why does the login page crash? ← a request

Type \ to see matching commands with a short description of each. Keep typing to narrow the list. \commands (or \help) shows everything. If you type /reset or :reset out of habit, NOVA reminds you to use a backslash instead.

Point NOVA at files

You don't need to paste code. NOVA finds and reads files itself. To point at a specific file, use @:

What does @src/utils/dates.py do?
  • Press Tab after @ to complete file names.
  • @ on an image, PDF, video or audio file attaches the file itself, so NOVA can look at it.
  • You can also drag a file into the terminal.
Tip: Attach a screenshot and NOVA can tell whether you want it to copy a design or fix a bug shown in the picture.

While NOVA works

  • A live checklist shows what NOVA has done, what it's doing, and what's left.
  • It asks when it's unsure. If your request could mean two different jobs, NOVA asks which one you meant.
  • Stop or redirect. Press Esc to stop. Type a correction, such as "use Postgres, not SQLite", and NOVA carries on from there. Anything already written is kept.
  • It can read web pages. Give NOVA a link and it reads the page instead of answering from memory.

How a task ends

When NOVA changes files, it runs your project's checks and shows a result such as PASS, followed by a short record of what changed. See Checks & Results.

Useful session commands

CommandWhat it does
\continuePick up the previous task where it stopped.
\resetStart a fresh conversation.
\clearClear the screen.
\compact / \generalShort or full header.
\exitLeave NOVA. Your session is saved.

Join our Discord

Chat with our engineers and become part of the active NOVA developer community.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.