Troubleshooting

​

CLI / install issues

​

b1e55ed: command not found

ls -la ~/.local/bin/b1e55ed || true

export PATH="$HOME/.local/bin:$PATH"
command -v b1e55ed
b1e55ed --version

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
. ~/.bashrc

curl -sSf https://raw.githubusercontent.com/P-U-C/b1e55ed/main/install.sh | bash

​

uv: command not found

export PATH="$HOME/.local/bin:$PATH"
command -v uv

​

API auth failures (401)

• API calls return 401 with auth.* error codes
• CLI commands that talk to the API fail with auth errors

​

Set via YAML

# config/user.yaml
api:
  auth_token: "your-secret-token"

​

Set via environment variable

export B1E55ED_API__AUTH_TOKEN="your-secret-token"

​

Kill switch active (HTTP 423)

​

Check current level

b1e55ed kill-switch
b1e55ed kill-switch --json | jq

​

Reset to level 0

b1e55ed kill-switch set 0

​

Database / event store issues

​

Verify integrity (hash chain)

b1e55ed integrity
b1e55ed integrity --json | jq

​

Rebuild projections

b1e55ed replay

​

Identity / forge issues

​

Forge not finding the 0xb1e55ed prefix

b1e55ed identity forge
# or increase parallelism
b1e55ed identity forge --threads 4

​

macOS: quarantine blocks the forge binary

xattr -dr com.apple.quarantine ~/.local/bin/b1e55ed

​

Secrets & exposure

​

Worried about secrets leaking?

• GET /api/v1/health is safe and intentionally minimal.
• Do not expose config endpoints publicly (e.g. GET /api/v1/config) unless you understand the risk.

• bind API/dashboard to 127.0.0.1 and access via Tailscale or SSH tunnel
• keep api.auth_token set

​

Logs

​

systemd logs

journalctl -u b1e55ed -n 100 --no-pager || true
journalctl -u b1e55ed-api.service -n 200 --no-pager || true
journalctl -u b1e55ed-brain.service -n 200 --no-pager || true

​

Port conflicts

sudo ss -ltnp | grep -E ':(5050|5051)\b' || true