Executor Runtime

The core Link commands work without Executor. The mere-link executor ... commands need a separate Executor-compatible HTTP runtime.

What Link Uses Executor For

Executor owns tool discovery, schemas, approvals, auth, and invocation for external systems. Link owns graph identity and write policy.

That split keeps the public package small:

• @merekit/link does not bundle Executor.
• @merekit/link has no npm dependency on Executor.
• Executor-backed commands talk to an HTTP runtime at command time.

Local Runtime

Install and start Executor separately.

npm install -g executor
executor web

Executor's default local runtime is http://127.0.0.1:4788. Link defaults to http://localhost:4788.

Configure Link

Use config:

integrations:
  executor:
    plugin: executor
    baseUrl: http://127.0.0.1:4788

Or use flags:

mere-link executor sources --executor-base-url http://127.0.0.1:4788 --json

Token Auth

If the runtime requires a bearer token, Link can read it from an environment variable.

export MERE_LINK_EXECUTOR_TOKEN=...
mere-link executor sources --json

You can also declare the token env var in config:

integrations:
  executor:
    plugin: executor
    baseUrl: https://executor.example.com
    tokenEnv: EXAMPLE_EXECUTOR_TOKEN

Or pass it at the command line:

mere-link executor sources --executor-token-env EXAMPLE_EXECUTOR_TOKEN --json

When a non-local Executor URL comes from mere.link.yaml, declare tokenEnv for that runtime. Link will not forward the global MERE_LINK_EXECUTOR_TOKEN to a non-local config URL.