Hillnote Logo

Tools on Hillnote

Tools are little HTML pages that can be written by most AI assistants to help you with simple tasks and to automate your workflow.

A tool is a small app in a single page, such as a timer, a calculator or a chart of your data. Tools live in your workspace's resources/html folder and run in a sandbox, and what they save goes into sheets in a Tools folder.

The pace-timer tool running in the side panel, a Rest break timer at 10:00 with Start, Reset and 5 min, 10 min and 20 min buttons, under the highlighted Tools & References button.

Need that tool to help you calculate the right timezone?
or a tool to create a random 21 digit number?
or maybe it's something to convert your image into hex values?
Just add a tool for it to your workspace!

Tools and plugins are desktop app only: the web app at app.hillnote.com doesn't run them.

Creating tools

There are two primary ways to create a tool

Using Tool Forge

  1. Open Tool Forge from the menu under the workspace name at the top of the sidebar (see App interface), or from the Tools & References panel.
  2. Describe what you want. Type @ to point at pages. Link data connects a collection or sheet, and Add as a view tab shows the tool as a view there.
  3. Click Build in App (⌘↵, or Ctrl+Enter on Windows) and choose your model. The AI writes the tool and opens it. Ask for edits and revise the tool until it works for you.

Tool Forge uses premium models, so sign in first. Create Spec Sheet (⇧⌘↵, or Ctrl+Shift+Enter on Windows) has Chat write a specification page to build from instead, and My Tools lists what you've made.

Tool Forge with a trail-distance calculator described, Brand voice linked with @, Linked to Trail guide and Add as a view tab checked, above Build in App and Create Spec Sheet.

Using your own AI

You could always connect your AI tool via MCP, the hillnote command or the file system, as defined in Connect your tools, and then ask it to create the tool. Connected AI tools can read Hillnote's tools guide, which tells them how to build one.

Using tools

Tools can be invoked across desktop and mobile. They sync across devices as well.

Sidebar on desktop

Open the Tools & References panel from the top bar. No button? Turn on Enable Tools Panel in Settings ▸ Editor. The panel lets you open your tools from a central place. You can

  1. Tools: Run, manage and pin tools. Pinned tools sit at the top: click one to run it, or hover it for Edit tool, Reveal in Finder, Open in Terminal or Remove from My Tools. All tools lists every tool, with Pin to My Tools and Delete tool. Register existing HTML file pins an HTML file from resources/html. If a tool shows errors, Fix with AI sends them to Tool Forge.
  2. Open a URL
  3. Search Wikipedia
  4. Open a PDF, image or other file as reference to the right.
Tools & References with the pace-timer tool pinned and hovered to show its edit, reveal, terminal and remove buttons, and water-planner under All tools (1).

In a page

Type / and choose Tools to open Embed a Tool. Pick one of your tools, or add one from a File, a Folder (up to 2 MB) or an HTML URL. The tool runs inside the page, with Edit title, Reload tool and Open in panel controls.

The water-planner tool embedded in the Packing list page under the checklist, its header showing Edit title, Reload tool and Open in panel above the running Water planner.

As a view

A Custom view shows a collection's or sheet's rows through a tool. Filters and search still apply, and edits in the tool save back to the rows. See Custom views in Database.

  1. Add a view to the collection or sheet and choose Custom.
  2. Pick a tool from Your tools, start from Templates such as Card deck or Flashcards, or describe a new one in Build with AI.
  3. If the tool asks for other data, click Allow or Deny. A tool only reaches the data you allow.

The view offers Change tool, Edit with AI, Reload tool and Open in sidebar.

A Custom view named Cards showing the roadmap rows as cards from the Card deck template, with Grid and Deck modes and the tool's actions in its header.

Mobile

Tools can be accessed by clicking the 4th tab up top in the workspace overview. This lists all tools available in the workspace. A widget is also available for quick access to a tool of your choice.

Pasted image

Plugins

Plugins add features to Hillnote: a side panel, a full-page view, new views for collections and sheets, or commands in the slash menu and search. They're experimental, and each workspace keeps its own in its plugins folder.

  1. Turn on Plugins (experimental) in Settings ▸ Editor.
  2. Open the ⋮ (more) menu in the top bar and choose Plugins. Browse community plugins lists plugins you can install, and Install from folder… adds one from your computer.
  3. A new plugin doesn't run until you enable it. Enable shows the permissions it wants: read them, then click Approve and enable.

Panel plugins get their own button in the top bar. Full-page plugins open from search (⌘K, or Ctrl+K on Windows), and one can be your New tab page in Settings ▸ Editor.

Plugins run in a sandbox and do only what you allow. Install only plugins you trust.

The Plugins panel, marked Experimental, with Momentum and Print Formats installed and an Enable button on each.

Install plugins

In the Plugins panel, Browse community plugins opens Community plugins. Click Install to download a verified copy into this workspace. When a newer version is out, Update appears.

To make your own, click New plugin: it creates a starter plugin for you to edit. Plugin API reference lists what plugins can do.

The Community plugins dialog, listing API Showcase v1.0.0 by Hillnote with an Install button.

Permissions and safety

  • Enable sorts the permissions a plugin wants under Granted on enable and Asks again on first use.
  • When a plugin asks for something later, choose Deny, Allow once or Always allow.
  • If a plugin's files change after you approved it, it shows Changed since approval and won't run until you Review it. New permissions need Re-approve.
  • Activity log lists every call the plugin has made since the app started.
  • Disable stops a plugin. Uninstall deletes its folder and its saved secrets.
The Enable Print Formats? dialog, with editor:read, ui:navigate, ui:interact and ui:commands under Granted on enable, export, files:write and ui:external under Asks again on first use, and Cancel and Approve and enable buttons.