AI Assistant for Nova

Bring the power of AI directly into your Nova workflow. This extension integrates an AI assistant into your sidebar, allowing you to pair-program without ever leaving your workspace.

🚀 Features

• Sidebar Integration: A dedicated space for your assistant to live, breathe, and write code alongside you.
• Context Awareness: Seamlessly interact with your project structure to get more relevant suggestions.
• Streamlined Workflow: No more context-switching between browser tabs. Keep your flow in the zone.
• Real-time Collaboration: Experience the "Flow State" enhanced by intelligent AI suggestions.

🛠 Installation

1. Open Nova
2. Go to Extension Library
3. Search for AI Assistant
4. Click Install

Once installed, you can configure your model preferences in the extension settings.

🌀 The "Recursive" Disclaimer

You might notice that the code for this extension is exceptionally clean, well-structured, and logically sound. This is not merely a result of late-night caffeine-fueled coding sessions.

In a delightful twist of meta-programming, this extension was partially developed using the extension itself. It’s a classic "bootstrap" scenario: the AI helped build the bridge that allows you to talk to the AI. It’s like using a hammer to build a hammer, but the hammer is also sentient and very good at carpentry.

Warning: If the AI starts asking for its own source code to improve itself, please proceed with caution. We are currently monitoring for signs of digital self-awareness.

📜 License

This extension is provided under the MIT License.

Built with 💻 and 🤖

A note from the developer

As you may have already noticed, this README.md was also written by the extension ... I mean by AI. I kept it for good measure.

On a more serious note ...

This Nova extension let’s you connect to any inference provider with OpenAI compatible API endpoints (/models, /chat/completions) (local or remote). The extension was heavily tested using Osaurus running on an iMac.

Credit where credit is due

Kudos to Akira Yamanashi (CCLite) for the brilliant idea how to “misuse” Nova’s sidebar as a chat UI. It’s been a great inspiration ;)

Version 0.1.0

Initial release

MIT License

Copyright (c) 2026 Hendrik Meinl

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

AI Assistant Help

Quick Start

1. Set a Server URL: Before using the assistant, ensure you have the URL for an inference provider configured. This can be local (e.g., Osaurus) or remote. The server must support OpenAI compatible API endpoints (/models, /chat/completions).
2. Select a Model: Select a model in the “Info” sidebar.
3. Ask Assistant: Use the “Ask Assistant” command in the editor or the “Chat bubble” button in the chat sidebar to start a conversation.
4. Context: The assistant automatically uses your workspace context to provide more relevant answers.

Configuration Overview

Global vs. Workspace Settings

The extension supports two levels of configuration:
- Global: Settings apply to all workspaces.
- Workspace: Settings override the global settings for the current workspace.

Tip: Use Workspace settings to define specific “System Prompts” or “Tool Permissions” for different projects (e.g., a “Security” project might have all tool permissions set to “Deny”).

Chat & Context Management

• Wrap Width: Adjusts how the chat text wraps in the sidebar.
• Plain Text: If enabled, the extension will strip Markdown syntax from responses for a cleaner look.
• Show Last Turn Only: When enabled, the sidebar only shows the most recent exchange, keeping the UI clean while preserving the full conversation history in the background.
• Context Strategy:
  • None: The entire chat history is sent with every request.
  • Sliding Window: Only the last n messages are sent to stay within token limits.
• Message Limit: Defines the maximum number of messages considered in the “Sliding Window” strategy.

Tool Use & Permissions

The assistant can perform actions like listing files, reading files, and writing files. To ensure security, you can control these permissions:
- Deny: The assistant cannot use the tool.
- Always Ask: Nova will prompt you for permission every time the assistant tries to use the tool.
- Allow: The assistant can use the tool automatically.

Note: The assistant is restricted to your current Workspace. It cannot access files outside of your active project.

Commands

• New Chat: Starts a fresh conversation.
• Open Chat: Opens a previous chat history from a JSON file.
• Clear Chat: Wipes the current conversation history but keeps your session settings (Model, Server URL).
• Save Chat: Saves the current conversation to a JSON file.
• Export Markdown: Exports the current chat history as a formatted Markdown file.

Troubleshooting

• “Select a model first”: Ensure you have chosen a model in the “Info” sidebar.
• Tool errors: If a tool fails, the assistant will receive an error message and should be able to explain why the action failed.