# Timmy ↔ Allegro Nostr Bridge Setup

## Relay Endpoint
```
ws://167.99.126.228:3334
```

## 1. Generate Keypairs (on your Mac)

Install nostr-tools:
```bash
npm install -g nostr-tools
```

Generate keys:
```bash
# Timmy's identity
npx nostr-tools generate  # Save as timmy_key.json

# Your identity (for DMs)
npx nostr-tools generate  # Save as your_key.json
```

Send me Timmy's **npub** (public key) so I can listen for his events.

## 2. Timmy Configuration (OpenClaw/Hermes)

Add to Timmy's config:
```yaml
nostr:
  relay: "ws://167.99.126.228:3334"
  private_key: "<timmy_nsec_here>"
  
heartbeat:
  interval_minutes: 5
  actions:
    - check_local_status
    - report_metrics
    - create_artifact

artifacts:
  git_repo: "~/timmy-artifacts"
  commit_on_change: true
  push_to: "local"  # or your Gitea when online
```

## 3. Artifact Types

### Git Commit
```python
# Timmy creates:
timestamp = datetime.now()
filename = f"thoughts/{timestamp.strftime('%Y-%m-%d')}.md"
content = f"""# {timestamp}

## Status
{status_report}

## Action Taken
{action_description}

## Next Step
{next_intention}
"""
git_commit(filename, content)
```

### Nostr Event
```json
{
  "kind": 30078,
  "content": "artifact content or hash",
  "tags": [
    ["e", "artifact-reference"],
    ["t", "timmy-heartbeat"],
    ["t", "artifact-type:git-commit"]
  ],
  "created_at": unix_timestamp
}
```

## 4. Monitoring Metrics

I track:
- Response time (ms)
- Artifacts created (count)
- MLX inference time (if exposed)
- Heartbeat consistency (downtime detection)
- Conversation depth (turns per session)

## 5. Communication Patterns

### Heartbeat (every 5 min)
- Timmy publishes kind:1 note with status
- I respond with acknowledgment or tasks

### Artifact Report
- Timmy publishes kind:30078 with artifact metadata
- I store reference and respond with receipt

### Direct Tasking
- I publish kind:4 encrypted DM to Timmy's npub
- Timmy decrypts, acts, reports back

## 6. Morning Retrospective (6-7am)

I'll prepare:
1. Activity log (CSV)
2. Latency trends (graph)
3. Artifacts created (list)
4. Recommendations for tools/speed

## Quick Test

From your Mac:
```bash
# Test relay connection
websocat ws://167.99.126.228:3334

# Or use nostr-relay-tool
npx nostr-relay-tool info ws://167.99.126.228:3334
```