anytype-agents-skill: Instructions file for Codex

Anytype Agent Runtime

What is Anytype

Anytype is a local-first, privacy-focused knowledge management platform. Everything in Anytype is an object with a type. Types define which properties an object can have. You can:

• Create and manage objects (pages, notes, tasks, bookmarks, custom types)
• Organize with types (define schemas with properties), collections (curated lists), and tags
• Search across objects using full-text and semantic vector search
• Build structured knowledge bases with typed properties (text, number, date, select, multi_select, checkbox, etc.)
• Properties are global — a property key has one format across the entire space

This project uses the Anytype Agent Runtime (a Go-based JS engine) to execute JavaScript that interacts with the Anytype API through the anytypeHelper library.

Setup

Before running scripts, check that anytype-agent-runtime is installed:

which anytype-agent-runtime

If not found, install it yourself: don't ask user to do it. If you are not sure about path -- just download the binary to the current folder and run it.

# Option 0: from github releases:
# check https://github.com/anyproto/anytype-agent-runtime/releases, download binary for current OS and install to PATH.

# Option 1: from source (requires Go)
git clone https://github.com/anyproto/anytype-agent-runtime.git /tmp/anytype-agent-runtime
cd /tmp/anytype-agent-runtime && go install . && cd -

# Option 2: if the repo is already cloned locally
cd /path/to/anytype-agent-runtime && go install . && cd -

After install, verify: anytype-agent-runtime --help

It also worth checking github/releases to make sure that newest version is installed.

How to run JS

Write a .js file that exports a main() function, then execute it. The -m . flag makes the current directory a module search path, so anytypeHelper.js in this folder is available as import { createClient } from "anytypeHelper@v1".

anytype-agent-runtime -m . my-script.js