mailbox

Name: mailbox
Author: Soul-Brews-Studio

109stars55forks

How to install mailbox?

soul-brews-studio/arra-oracle-skills-cli/mailbox

$npx -y skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill mailbox

Installs into the current project.

Summary

Persistent agent mailbox — store findings, standing orders, and context for team agents across sessions. Use when user says "mailbox", "agent memory", "standing orders", "what did scout find", or wants to manage persistent agent knowledge.

Files · 1

View on GitHub

SKILL.md

1	# /mailbox — Persistent Agent Memory
2
3	> Agents die. Knowledge survives. ψ/ remembers what ~/.claude/ forgets.
4
5	Team agents in Claude Code use ephemeral file-based mailboxes that die with the session. /mailbox adds a persistent layer in ψ/memory/mailbox/ — agents remember across sessions.
6
7	## Usage
8
9	```
10	/mailbox # List all agent mailboxes
11	/mailbox read <agent> # Read agent's mailbox
12	/mailbox read-all # Read all mailboxes
13	/mailbox write <agent> "<subject>" "<msg>" # Write finding to agent
14	/mailbox orders <agent> "<instructions>" # Set standing orders
15	/mailbox load <agent> # Pre-load context for spawn prompt
16	/mailbox archive <agent> <team> # Archive session end
17	/mailbox clear <agent> # Clear mailbox (→ /tmp, not deleted)
18	```
19
20	---
21
22	## How It Works
23
24	### Storage: ψ/memory/mailbox/
25
26	```
27	ψ/memory/mailbox/
28	├── scout/
29	│ ├── standing-orders.md ← permanent instructions
30	│ ├── 2026-04-13_findings.md ← what scout found (append-only)
31	│ ├── 2026-04-14_findings.md ← next session's findings
32	│ ├── context.md ← saved working context
33	│ └── 2026-04-13_session-end.md ← archive marker
34	├── builder/
35	│ ├── standing-orders.md
36	│ └── 2026-04-13_findings.md
37	└── auditor/
38	└── standing-orders.md
39	```
40
41	Why ψ/, not ~/.claude/?
42
43	\| Location \| Owner \| Lifetime \| Purpose \|
44	\|----------\|-------\|----------\|---------\|
45	\| `~/.claude/teams/` \| Claude Code \| Session only \| Team config, ephemeral mailbox \|
46	\| `~/.claude/tasks/` \| Claude Code \| Session only \| Task tracking \|
47	\| `ψ/memory/mailbox/` \| Oracle \| Forever \| Persistent agent knowledge \|
48
49	Claude Code's data dies with the session. Our data lives in the vault. Nothing is Deleted.
50
51	---
52
53	## Step 0: Run the Script
54
55	```bash
56	date "+🕐 %H:%M %Z (%A %d %B %Y)"
57	bash ~/.claude/skills/mailbox/scripts/mailbox.sh [command] [args]
58	```
59
60	The script handles all operations. Parse the user's `/mailbox` arguments and pass them through.
61
62	---
63
64	## Commands
65
66	### `/mailbox list`
67
68	Show all agents with mailboxes:
69
70	```
71	📬 Agent Mailboxes (ψ/memory/mailbox/)
72
73	scout 3 files orders: yes last: 2026-04-13
74	builder 1 files orders: no last: 2026-04-13
75	auditor 1 files orders: yes last: never
76	```
77
78	### `/mailbox read <agent>`
79
80	Show an agent's mailbox — standing orders + latest findings:
81
82	```
83	📬 Mailbox: scout
84
85	📋 Standing Orders:
86	Always check security implications first. Report severity levels.
87
88	📝 Latest Findings (2026-04-13_findings.md):
89	## Session 4 findings
90	Found ghost agent bug in Claude Code...
91
92	Total files: 3
93	```
94
95	### `/mailbox write <agent> "<subject>" "<content>"`
96
97	Append a finding to the agent's mailbox:
98
99	```
100	📬 Written to scout's mailbox: Session 4 findings
101	```
102
103	### `/mailbox orders <agent> "<instructions>"`
104
105	Set permanent standing orders for an agent. These are pre-loaded into every spawn:
106
107	```
108	📋 Standing orders set for scout
109	```
110
111	### `/mailbox load <agent>`
112
113	Output agent's context in a format ready to inject into a spawn prompt. Used by /team-agents when spawning agents with memory:
114
115	```markdown
116	## Previous Context for scout
117
118	### Standing Orders
119	Always check security implications first.
120
121	### Last Session Findings
122	Found ghost agent bug in Claude Code...
123	```
124
125	### `/mailbox archive <agent> <team>`
126
127	Mark session end. Called during /team-agents shutdown:
128
129	```
130	📦 Session archived for scout (team: whetstone-ops)
131	```
132
133	### `/mailbox clear <agent>`
134
135	Move mailbox to /tmp (Nothing is Deleted):
136
137	```
138	📦 scout mailbox moved to /tmp/mailbox-scout-20260413_104500
139	```
140
141	---
142
143	## Integration with /team-agents
144
145	### On Spawn (auto-load)
146
147	When /team-agents spawns an agent, it pre-loads mailbox context:
148
149	```bash
150	CONTEXT=$(bash ~/.claude/skills/mailbox/scripts/mailbox.sh load scout 2>/dev/null)
151	```
152
153	Injected into the agent's prompt so it starts with memory.
154
155	### On Shutdown (auto-archive)
156
157	When /team-agents shuts down, it archives each agent's session:
158
159	```bash
160	bash ~/.claude/skills/mailbox/scripts/mailbox.sh archive scout whetstone-ops
161	```
162
163	### Standing Orders + Spawn
164
165	If scout has standing orders, every spawn includes them:
166
167	```
168	You are scout on team "whetstone-ops".
169
170	## Previous Context (from ψ/memory/mailbox/scout/)
171
172	### Standing Orders
173	Always check security implications first. Report severity levels.
174
175	### Last Session Findings
176	Found ghost agent bug in Claude Code. isActive() returns true always.
177	```
178
179	Scout starts every session knowing what it knows.
180
181	---
182
183	## Rules
184
185	1. **ψ/ is hom

People who liked this also viewed

6 picks

Type

mailbox

109stars55forks

View on GitHub

How to install mailbox?

soul-brews-studio/arra-oracle-skills-cli/mailbox

$npx -y skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill mailbox

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /mailbox — Persistent Agent Memory
2
3	> Agents die. Knowledge survives. ψ/ remembers what ~/.claude/ forgets.
4
5	Team agents in Claude Code use ephemeral file-based mailboxes that die with the session. /mailbox adds a persistent layer in ψ/memory/mailbox/ — agents remember across sessions.
6
7	## Usage
8
9	```
10	/mailbox # List all agent mailboxes
11	/mailbox read <agent> # Read agent's mailbox
12	/mailbox read-all # Read all mailboxes
13	/mailbox write <agent> "<subject>" "<msg>" # Write finding to agent
14	/mailbox orders <agent> "<instructions>" # Set standing orders
15	/mailbox load <agent> # Pre-load context for spawn prompt
16	/mailbox archive <agent> <team> # Archive session end
17	/mailbox clear <agent> # Clear mailbox (→ /tmp, not deleted)
18	```
19
20	---
21
22	## How It Works
23
24	### Storage: ψ/memory/mailbox/
25
26	```
27	ψ/memory/mailbox/
28	├── scout/
29	│ ├── standing-orders.md ← permanent instructions
30	│ ├── 2026-04-13_findings.md ← what scout found (append-only)
31	│ ├── 2026-04-14_findings.md ← next session's findings
32	│ ├── context.md ← saved working context
33	│ └── 2026-04-13_session-end.md ← archive marker
34	├── builder/
35	│ ├── standing-orders.md
36	│ └── 2026-04-13_findings.md
37	└── auditor/
38	└── standing-orders.md
39	```
40
41	Why ψ/, not ~/.claude/?
42
43	\| Location \| Owner \| Lifetime \| Purpose \|
44	\|----------\|-------\|----------\|---------\|
45	\| `~/.claude/teams/` \| Claude Code \| Session only \| Team config, ephemeral mailbox \|
46	\| `~/.claude/tasks/` \| Claude Code \| Session only \| Task tracking \|
47	\| `ψ/memory/mailbox/` \| Oracle \| Forever \| Persistent agent knowledge \|
48
49	Claude Code's data dies with the session. Our data lives in the vault. Nothing is Deleted.
50
51	---
52
53	## Step 0: Run the Script
54
55	```bash
56	date "+🕐 %H:%M %Z (%A %d %B %Y)"
57	bash ~/.claude/skills/mailbox/scripts/mailbox.sh [command] [args]
58	```
59
60	The script handles all operations. Parse the user's `/mailbox` arguments and pass them through.
61
62	---
63
64	## Commands
65
66	### `/mailbox list`
67
68	Show all agents with mailboxes:
69
70	```
71	📬 Agent Mailboxes (ψ/memory/mailbox/)
72
73	scout 3 files orders: yes last: 2026-04-13
74	builder 1 files orders: no last: 2026-04-13
75	auditor 1 files orders: yes last: never
76	```
77
78	### `/mailbox read <agent>`
79
80	Show an agent's mailbox — standing orders + latest findings:
81
82	```
83	📬 Mailbox: scout
84
85	📋 Standing Orders:
86	Always check security implications first. Report severity levels.
87
88	📝 Latest Findings (2026-04-13_findings.md):
89	## Session 4 findings
90	Found ghost agent bug in Claude Code...
91
92	Total files: 3
93	```
94
95	### `/mailbox write <agent> "<subject>" "<content>"`
96
97	Append a finding to the agent's mailbox:
98
99	```
100	📬 Written to scout's mailbox: Session 4 findings
101	```
102
103	### `/mailbox orders <agent> "<instructions>"`
104
105	Set permanent standing orders for an agent. These are pre-loaded into every spawn:
106
107	```
108	📋 Standing orders set for scout
109	```
110
111	### `/mailbox load <agent>`
112
113	Output agent's context in a format ready to inject into a spawn prompt. Used by /team-agents when spawning agents with memory:
114
115	```markdown
116	## Previous Context for scout
117
118	### Standing Orders
119	Always check security implications first.
120
121	### Last Session Findings
122	Found ghost agent bug in Claude Code...
123	```
124
125	### `/mailbox archive <agent> <team>`
126
127	Mark session end. Called during /team-agents shutdown:
128
129	```
130	📦 Session archived for scout (team: whetstone-ops)
131	```
132
133	### `/mailbox clear <agent>`
134
135	Move mailbox to /tmp (Nothing is Deleted):
136
137	```
138	📦 scout mailbox moved to /tmp/mailbox-scout-20260413_104500
139	```
140
141	---
142
143	## Integration with /team-agents
144
145	### On Spawn (auto-load)
146
147	When /team-agents spawns an agent, it pre-loads mailbox context:
148
149	```bash
150	CONTEXT=$(bash ~/.claude/skills/mailbox/scripts/mailbox.sh load scout 2>/dev/null)
151	```
152
153	Injected into the agent's prompt so it starts with memory.
154
155	### On Shutdown (auto-archive)
156
157	When /team-agents shuts down, it archives each agent's session:
158
159	```bash
160	bash ~/.claude/skills/mailbox/scripts/mailbox.sh archive scout whetstone-ops
161	```
162
163	### Standing Orders + Spawn
164
165	If scout has standing orders, every spawn includes them:
166
167	```
168	You are scout on team "whetstone-ops".
169
170	## Previous Context (from ψ/memory/mailbox/scout/)
171
172	### Standing Orders
173	Always check security implications first. Report severity levels.
174
175	### Last Session Findings
176	Found ghost agent bug in Claude Code. isActive() returns true always.
177	```
178
179	Scout starts every session knowing what it knows.
180
181	---
182
183	## Rules
184
185	1. **ψ/ is hom

People who liked this also viewed

6 picks

Type