Neptunionbuilt on Octropy Download

Your notes, for your AI agent.

Let the agent you already use read, search and write your Neptunion notes: pages, databases, LaTeX papers, meeting transcripts. One step, on your own computer. You choose what it may do, and you see it work.

Claude Code

Have Neptunion open, with the space you want Claude to work in.

  1. Add Neptunion's plugin.

    In Claude Code, type these two lines. The plugin connects Claude to Neptunion and teaches it how your pages work.

    /plugin marketplace add SynomyCloud/neptunion-agent
    /plugin install neptunion@neptunion

    Or only the connection, from a terminal: claude mcp add --transport http -s user neptunion http://127.0.0.1:51741/mcp

  2. Allow it, once.

    Type /mcp, choose neptunion and Authenticate. Your browser opens a page from Neptunion itself: choose how far Claude reaches and what it may do, and press Allow.

  3. Ask.

    “Summarise every meeting that has no summary yet.” “Put last week's action items into a page called Week 44.” “Add a Due column to my Tasks database and fill it in.” “Write the introduction of my paper in LaTeX.”

    For the meetings there is a command of its own: /neptunion:summarize-meetings.

What your agent can do

  • Find and read any page it may reach, search your notes, and follow what changes.
  • Write: make pages, change words in them without disturbing the rest, add pictures, move pages around.
  • Fill databases: add rows, set their values, add and rename columns.
  • Write LaTeX and HTML projects: make one from a template and write its files. Neptunion compiles it while you have it open.
  • Summarise your meetings: find every meeting without a summary, read its transcript, and write the summary into it, with each point linked to the moment it was said. Let them pile up and ask once.
  • Undo its own mistakes: what it deletes goes to the trash, and every page keeps its history.

You see it work

While your agent works, it has a pointer in your window, like a friend editing the same page. It goes to what the agent reads, presses where it writes, and the words it changed light up for a moment. The pointer carries the agent's name and its own colours, so you always know it is an AI and not a person.

You stay in charge

Your notes never leave your computer for this: the agent talks to Neptunion on your own machine, at 127.0.0.1, and only while Neptunion runs. When it asks to connect, you choose how far it reaches: every space, only the spaces you tick, one page and what is inside it, or only meeting transcripts, and whether it may only read, also change, or also delete. Every agent you let in is listed in Settings → API under its own name, and removing it there stops it at once.

If something does not work

  • The agent cannot reach Neptunion. Neptunion has to be running. If you chose another port in Settings → API, use that number instead of 51741 (the plugin and install.sh read it from NEPTUNION_PORT).
  • It cannot find a space. An agent let into every space reaches each space Neptunion has opened on this computer, so open it once. One you let into chosen spaces keeps to those: tick another for it in Settings → API (Edit beside it).
  • It may not do something. Remove it in Settings → API and connect it again with more access.
  • For your own scripts, the full guide to Neptunion's API is served by the app itself at 127.0.0.1:51741 while it runs (Settings → API → Steps for every agent).