@activefs/config

Configuration and local state helpers for ActiveFS workspaces.

Use this package when you need to read or write .activefs/config.json, describe remotes, evaluate local policy, or resolve per-remote state paths.

Install

npm install @activefs/config

Requires Node.js 20 or newer.

Small Example

import {
  loadActiveFSConfig,
  resolveActiveFSState,
  upsertActiveFSRemote
} from "@activefs/config";

const state = resolveActiveFSState(process.cwd());

await upsertActiveFSRemote(process.cwd(), {
  name: "docs",
  url: "http://127.0.0.1:3999/activefs/v1/",
  mountPath: "/docs",
  auth: { type: "none" }
});

const config = await loadActiveFSConfig(state.stateRoot);
console.log(config.remotes.docs.url);

What It Owns

• ActiveFS state-root discovery.
• .activefs/config.json loading and saving.
• Remote descriptors, mountpoint associations, and per-remote state layout.
• Auth provider descriptors.
• Local policy evaluation helpers.

This package stores configuration only. Remote services and tree implementations remain authoritative for access control and mutation outcomes.

Docs

• CLI configuration flow: https://github.com/ankitparasher/activefs/blob/main/docs/reference/cli.md
• Security and identity: https://github.com/ankitparasher/activefs/blob/main/docs/guides/security-and-identity.md
• Current limits: https://github.com/ankitparasher/activefs/blob/main/docs/reference/current-limits.md