actx init

actx init

Initialize AgentCTX in the current project directory.

Usage

actx init

What It Does

1. Creates the .context/ directory structure:

   .context/
   ├── actx.yaml        # Gateway configuration
   ├── objects/          # Content-addressed object store
   ├── refs/             # Reference pointers
   ├── translations/     # Signed sidecar translations
   └── logs/             # Operation audit logs

2. Generates an Ed25519 signing keypair at .context/.keys/:

   .context/.keys/
   ├── ed25519.key      # Private key
   └── ed25519.pub      # Public key

3. Generates a project salt for convergent encryption:

   • With OP_SERVICE_ACCOUNT_TOKEN set: fetches salt from 1Password vault
   • Without it: generates a local project.salt file (with a security warning)

4. Creates a default actx.yaml configuration with all seven planes enabled

Default Configuration

version: "0.1.0"
project: my-project-name
backends: []
planes:
  tools:
    enabled: true
  knowledge:
    enabled: true
    sources: ["docs/", "src/"]
  skills:
    enabled: true
    sources: [".agent/"]
  memory:
    enabled: true

Environment Variables

Variable	Effect
OP_SERVICE_ACCOUNT_TOKEN	If set, fetches project salt from 1Password vault instead of generating locally

Example

$ cd my-project
$ actx init
🔧 Initializing AgentCTX...

  ✅ Created .context/ directory structure
  ✅ Generated Ed25519 signing keypair
  ✅ Generated project salt (scoped CE)
  ✅ Created actx.yaml config

See Also

• actx add — register an MCP backend
• actx start — start the gateway
• Configuration — full config reference