Configuration Reference

Priority 1 (highest): CLI flags / MCP server arguments
Priority 2:           Environment variables
Priority 3:           Configuration file (~/.config/agentic-comm/config.toml)
Priority 4 (lowest):  Built-in defaults

1. .acomm/store.acomm    (current working directory)
2. ~/.store.acomm         (home directory fallback)

# ~/.config/agentic-comm/config.toml

# -----------------------------------------------------------------------
# Store settings
# -----------------------------------------------------------------------
[store]
# Default path for the .acomm store file.
# Overridden by ACOMM_STORE env var and --file/--store flags.
default_path = "~/Documents/agentic/comm.acomm"

# When to write the store to disk.
# Values: "immediate", "batch", "manual"
flush_mode = "batch"

# Number of operations before auto-flush (batch mode only).
batch_size = 100

# Max delay in milliseconds before auto-flush (batch mode only).
batch_delay_ms = 5000

# -----------------------------------------------------------------------
# Default identities
# -----------------------------------------------------------------------
[defaults]
# Default sender participant ID for CLI commands.
sender = "claude-code"

# Default channel name for CLI commands.
channel = "main"

# -----------------------------------------------------------------------
# Logging
# -----------------------------------------------------------------------
[logging]
# Log level: trace, debug, info, warn, error
level = "info"

# Optional log file path. When set, logs are written to this file
# in addition to stderr.
# file = "/var/log/agentic-comm.log"

# -----------------------------------------------------------------------
# Identity integration
# -----------------------------------------------------------------------
[identity]
# AgenticIdentity name for message signing. When set, messages sent
# through the CLI and MCP server are signed with this identity.
# Requires agentic-identity to be installed and configured.
# name = "default"

# -----------------------------------------------------------------------
# Resource limits
# -----------------------------------------------------------------------
[limits]
# Maximum message content size in bytes.
max_message_size = 1048576

# Maximum number of channels per store.
max_channels = 100000

# Maximum number of messages per store.
max_messages = 10000000

# Maximum number of subscriptions per store.
max_subscriptions = 1000000

# Create the config directory
mkdir -p ~/.config/agentic-comm

# Create a minimal config
cat > ~/.config/agentic-comm/config.toml << 'EOF'
[store]
default_path = "~/Documents/agentic/comm.acomm"

[defaults]
sender = "my-agent"

[logging]
level = "info"
EOF

1. --file <PATH>                       (explicit flag)
2. ACOMM_STORE environment variable    (env var)
3. .acomm/store.acomm                  (local directory, if exists)
4. ~/.store.acomm                      (home directory fallback)

1. --store <PATH>                      (server argument)
2. ACOMM_STORE environment variable    (env var)
3. .acomm/store.acomm                  (local directory, if exists)
4. ~/.store.acomm                      (home directory fallback)

cd /path/to/my-project
mkdir -p .acomm

# .gitignore
*.acomm
*.acomm.lock
*.acomm.tmp
*.acomm.bak

~/projects/
+-- frontend/
|   +-- .acomm/
|   |   +-- store.acomm     <-- frontend communication history
|   +-- src/
|
+-- backend/
|   +-- .acomm/
|   |   +-- store.acomm     <-- backend communication history
|   +-- src/
|
+-- infra/
    +-- .acomm/
    |   +-- store.acomm     <-- infra communication history
    +-- terraform/

{
  "mcpServers": {
    "agentic-comm": {
      "command": "agentic-comm-mcp",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "agentic-comm": {
      "command": "agentic-comm-mcp",
      "args": ["--store", ".acomm/store.acomm"]
    }
  }
}

agentic-comm-mcp [OPTIONS]

Options:
  --store <PATH>        Store file path [default: resolved via standard chain]
  --log-level <LEVEL>   Log level [default: warn]
  --mode <MODE>         Session mode: full, minimal [default: full]

# Set before launching Claude Code
export ACOMM_STORE=/path/to/project/comm.acomm
export ACOMM_LOG_LEVEL=debug

# Now start Claude Code — the MCP server inherits these
claude

export ACOMM_FLUSH_MODE=immediate

export ACOMM_FLUSH_MODE=batch
export ACOMM_BATCH_SIZE=100
export ACOMM_BATCH_DELAY_MS=5000

export ACOMM_FLUSH_MODE=manual

# Check the resolved store path
ACOMM_LOG_LEVEL=debug acomm info test.acomm 2>&1 | head -5

# Check environment variables
env | grep ACOMM

# Check if local .acomm directory exists
ls -la .acomm/ 2>/dev/null || echo "No local .acomm directory"

# Check config file
cat ~/.config/agentic-comm/config.toml 2>/dev/null || echo "No config file"

export ACOMM_STORE=.acomm/store.acomm
export ACOMM_LOG_LEVEL=debug
export ACOMM_FLUSH_MODE=immediate
export ACOMM_SENDER=dev-agent

export ACOMM_STORE=/tmp/ci-comm.acomm
export ACOMM_LOG_LEVEL=error
export ACOMM_FLUSH_MODE=manual
export ACOMM_SENDER=ci-agent

# Use per-project isolation (no env vars needed)
mkdir -p .acomm
# Config file handles defaults