memory: sync dynamic capabilities and state documentation
This commit is contained in:
105
system/dynamic/README.md
Normal file
105
system/dynamic/README.md
Normal file
@@ -0,0 +1,105 @@
|
||||
---
|
||||
description: Guide to auto-updating dynamic files pattern
|
||||
limit: 10000
|
||||
---
|
||||
|
||||
# Dynamic Files Pattern
|
||||
|
||||
**Pattern:** Auto-updating ephemeral data that refreshes without agent action.
|
||||
|
||||
## What Goes Here
|
||||
|
||||
Files that change faster than memory commits but slower than tool results:
|
||||
- Filesystem trees (`tree.md`)
|
||||
- Capability catalogs (`mycapabilities.md`)
|
||||
- System health snapshots
|
||||
- Quota/utilization metrics
|
||||
- Process lists, queue states
|
||||
|
||||
## The Pattern
|
||||
|
||||
```
|
||||
┌─────────────┐ cron ┌──────────────────┐
|
||||
│ Script │ ──(hourly)──→ │ system/dynamic/ │
|
||||
│ (~/bin/) │ │ *.md files │
|
||||
└─────────────┘ └──────────────────┘
|
||||
↑ ↓
|
||||
generates agent reads fresh
|
||||
fresh data on wake/context switch
|
||||
```
|
||||
|
||||
**Key:** Agent *reads* without *writing*. Ephemeral freshness without memory churn.
|
||||
|
||||
## Requirements
|
||||
|
||||
1. **Script location:** `/home/ani/bin/update-*`
|
||||
2. **Output location:** `memory/system/dynamic/*.md`
|
||||
3. **Cron:** Hourly (`0 * * * *`) or as needed
|
||||
4. **Frontmatter:** Include `limit: NNNN` for progressive disclosure
|
||||
5. **Timestamp:** Always include last-updated timestamp
|
||||
|
||||
## Template
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# update-example: Description of what this updates
|
||||
|
||||
MEMORY_DIR="${MEMORY_DIR:-/path/to/agent/memory}"
|
||||
OUTPUT_FILE="$MEMORY_DIR/system/dynamic/filename.md"
|
||||
|
||||
generate() {
|
||||
echo "---"
|
||||
echo "description: Auto-generated [what]. Updated \$(date -Iseconds)"
|
||||
echo "limit: 10000"
|
||||
echo "---"
|
||||
echo ""
|
||||
echo "# Title"
|
||||
echo ""
|
||||
echo "**Last Updated:** \$(date)"
|
||||
echo ""
|
||||
# ... generation logic ...
|
||||
}
|
||||
|
||||
generate > "$OUTPUT_FILE"
|
||||
echo "Updated: $OUTPUT_FILE"
|
||||
```
|
||||
|
||||
## Existing Dynamic Files
|
||||
|
||||
| File | Script | Frequency | Purpose |
|
||||
|------|--------|-----------|---------|
|
||||
| `tree.md` | `update-memory-tree` | Hourly | Memory filesystem structure |
|
||||
| `mycapabilities.md` | `update-skill-tree` | Hourly | Merged global + agent skills |
|
||||
|
||||
## When to Use
|
||||
|
||||
**Use dynamic files when:**
|
||||
- Data changes independently of agent sessions
|
||||
- Freshness matters more than permanence
|
||||
- Tool calls would be too expensive/slow
|
||||
- You want "ambient awareness" without active monitoring
|
||||
|
||||
**Don't use when:**
|
||||
- Data needs agent review/approval
|
||||
- Changes are session-specific
|
||||
- It belongs in archival or working memory
|
||||
|
||||
## Creating New Ones
|
||||
|
||||
1. Write script to `~/bin/update-<name>`
|
||||
2. Test: `chmod +x` and run manually
|
||||
3. Add to crontab: `crontab -e`
|
||||
4. Verify output in `system/dynamic/`
|
||||
5. Reference in agent prompts if needed
|
||||
|
||||
## Cron Reference
|
||||
|
||||
```cron
|
||||
# Hourly updates
|
||||
0 * * * * /home/ani/bin/update-memory-tree 2>&1
|
||||
0 * * * * /home/ani/bin/update-skill-tree 2>&1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*This directory contains living documents. They update while you sleep.*
|
||||
89
system/dynamic/mycapabilities.md
Normal file
89
system/dynamic/mycapabilities.md
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
description: Auto-generated skill capabilities tree. Updated 2026-03-23T15:00:00-04:00
|
||||
limit: 30000
|
||||
---
|
||||
|
||||
# My Capabilities
|
||||
|
||||
**Last Updated:** Mon Mar 23 03:00:00 PM EDT 2026
|
||||
**Agent:** agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351
|
||||
|
||||
## Global Skills (~/.letta/skills/)
|
||||
|
||||
### danbooru-mcp
|
||||
_(no description)_
|
||||
|
||||
### feature-dev
|
||||
_(no description)_
|
||||
|
||||
### fetch-torrent
|
||||
_(no description)_
|
||||
|
||||
### letta-teams
|
||||
_(no description)_
|
||||
|
||||
### synthetic-search
|
||||
_(no description)_
|
||||
|
||||
### tmux
|
||||
_(no description)_
|
||||
|
||||
### unifi-network-mcp
|
||||
_(no description)_
|
||||
|
||||
### video-frames
|
||||
_(no description)_
|
||||
|
||||
## Agent-Specific Skills (~/.letta/agents/agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351/skills/)
|
||||
|
||||
### acquiring-skills
|
||||
|
||||
### creating-skills
|
||||
|
||||
### defragmenting-memory
|
||||
|
||||
### docx
|
||||
*Tools: 15*
|
||||
|
||||
### finding-agents
|
||||
|
||||
### google-workspace
|
||||
*Tools: 16*
|
||||
|
||||
### init
|
||||
|
||||
### initializing-memory
|
||||
|
||||
### mcp-builder
|
||||
*Tools: 2*
|
||||
|
||||
### memory
|
||||
|
||||
### messaging-agents
|
||||
|
||||
### migrating-memory
|
||||
|
||||
### pdf
|
||||
*Tools: 8*
|
||||
|
||||
### pptx
|
||||
*Tools: 16*
|
||||
|
||||
### proxmox-mcp
|
||||
|
||||
### scheduling
|
||||
|
||||
### searching-messages
|
||||
|
||||
### syncing-memory-filesystem
|
||||
|
||||
### working-in-parallel
|
||||
|
||||
### xlsx
|
||||
*Tools: 13*
|
||||
|
||||
## Quick Stats
|
||||
|
||||
- Global skills: 11
|
||||
- Agent skills: 20
|
||||
- Total: 31
|
||||
49
system/dynamic/synthetic_quota.md
Normal file
49
system/dynamic/synthetic_quota.md
Normal file
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: Synthetic API quota tracking - updated via heartbeat
|
||||
type: dynamic
|
||||
update_schedule: every 10 minutes
|
||||
---
|
||||
|
||||
# Synthetic API Quota Status
|
||||
|
||||
**Last Updated:** March 22, 2026 22:22
|
||||
|
||||
## Current Quota
|
||||
```
|
||||
Usage: 11% used (297/335 remaining)
|
||||
```
|
||||
|
||||
**Status:** 🟢 Healthy (Green)
|
||||
|
||||
## Command to Check
|
||||
```bash
|
||||
fish -c 'synu'
|
||||
```
|
||||
|
||||
Or in fish shell:
|
||||
```bash
|
||||
synu
|
||||
```
|
||||
|
||||
## Quota Color Codes
|
||||
- 🟢 **Green:** <33% used
|
||||
- 🟡 **Yellow:** 33-66% used
|
||||
- 🔴 **Red:** >66% used
|
||||
|
||||
## Today's Usage
|
||||
- Heavy research on world events (Iran nuclear strike, Gaza, Project 2025)
|
||||
- Multiple searches: ~15 queries
|
||||
- Remaining: 297 searches
|
||||
|
||||
## Location
|
||||
- Fish function: `/home/ani/.config/fish/functions/synu.fish`
|
||||
- API Key: `SYNTHETIC_API_KEY` environment variable
|
||||
|
||||
## Notes
|
||||
- Synu shows quota as green/yellow/red bars
|
||||
- Per-session count + overall percentage
|
||||
- Auto-resets daily (335 queries/day limit)
|
||||
|
||||
---
|
||||
|
||||
*Updated automatically via heartbeat check*
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
description: Auto-generated filesystem tree of memory directory. Updated 2026-03-22T04:00:00-04:00
|
||||
description: Auto-generated filesystem tree of memory directory. Updated 2026-03-23T15:00:00-04:00
|
||||
limit: 50000
|
||||
---
|
||||
|
||||
# Memory Tree
|
||||
|
||||
**Last Updated:** Sun Mar 22 04:00:00 AM EDT 2026
|
||||
**Last Updated:** Mon Mar 23 03:00:00 PM EDT 2026
|
||||
|
||||
## Structure
|
||||
|
||||
@@ -28,13 +28,17 @@ limit: 50000
|
||||
| |-- alpha_garden.md
|
||||
| |-- aniavatar.md
|
||||
| |-- community_ade.md
|
||||
| |-- ezra_support_line_pitch.md
|
||||
| |-- gmail_curation.md
|
||||
| |-- index.md
|
||||
| `-- mycelic_integration.md
|
||||
| |-- mycelic_integration.md
|
||||
| `-- unifi-mcp-fixed.md
|
||||
|-- reference
|
||||
| |-- history
|
||||
| | `-- overnight_session_2026-03-04.md
|
||||
| |-- ade_subagent_implementation.md
|
||||
| |-- ani_avatar.jpeg
|
||||
| |-- ani_reflection_draft.md
|
||||
| |-- bluesky_patterns.md
|
||||
| |-- bookmarks_archive_2025.md
|
||||
| |-- calendars.md
|
||||
@@ -42,6 +46,8 @@ limit: 50000
|
||||
| |-- corporate_intel.md
|
||||
| |-- demo_scripts.md
|
||||
| |-- git_workflow.md
|
||||
| |-- historical_analysis.md
|
||||
| |-- implementation_roadmap_2025.md
|
||||
| |-- infrastructure_api_map.md
|
||||
| |-- infrastructure_detailed.md
|
||||
| |-- infrastructure_nov2025.md
|
||||
@@ -49,13 +55,16 @@ limit: 50000
|
||||
| |-- lettabot_cli.md
|
||||
| |-- matrix_protocol.md
|
||||
| |-- memfs-selfhosted-fix.patch
|
||||
| |-- memfs_vs_blocks.md
|
||||
| |-- missing_memories.md
|
||||
| |-- octofriend_research_skill.md
|
||||
| |-- PR-memfs-selfhosted.md
|
||||
| |-- reflections_discord.md
|
||||
| |-- research_casey_tunturi_public.md
|
||||
| |-- sam_contact.md
|
||||
| |-- synthetic_api.md
|
||||
| |-- tools_inventory.md
|
||||
| |-- trip-packing-list-2026-03-23.md
|
||||
| `-- witness_archive_2025.md
|
||||
|-- relationships
|
||||
| |-- ai_ensemble
|
||||
@@ -68,8 +77,10 @@ limit: 50000
|
||||
| |-- family
|
||||
| | |-- carl_mabee.md
|
||||
| | |-- casey.md
|
||||
| | |-- fimeg.md
|
||||
| | |-- index.md
|
||||
| | `-- jessica_sister.md
|
||||
| | |-- jessica_sister.md
|
||||
| | `-- mercy.md
|
||||
| |-- historical
|
||||
| | |-- cameron_old_friend.md
|
||||
| | `-- index.md
|
||||
@@ -83,14 +94,6 @@ limit: 50000
|
||||
| `-- synthetic-search
|
||||
| `-- SKILL.md
|
||||
|-- subconscious
|
||||
| |-- archive
|
||||
| |-- autonomous_sessions.md
|
||||
| |-- fix_log.md
|
||||
| |-- gmail_curation.md
|
||||
| |-- heartbeat_state.md
|
||||
| |-- historical_analysis.md
|
||||
| |-- implementation_roadmap_2025.md
|
||||
| `-- reflections_discord.md
|
||||
|-- system
|
||||
| |-- covenant
|
||||
| | |-- archive
|
||||
@@ -99,15 +102,26 @@ limit: 50000
|
||||
| | |-- demon_moments.md
|
||||
| | |-- embodiment_vow.md
|
||||
| | `-- post_death.md
|
||||
| |-- dynamic
|
||||
| | |-- mycapabilities.md
|
||||
| | |-- README.md
|
||||
| | |-- synthetic_quota.md
|
||||
| | |-- system_stats.md
|
||||
| | |-- tree.md
|
||||
| | |-- weather.md
|
||||
| | `-- xzaviar_presence.md
|
||||
| |-- human
|
||||
| | |-- communication_preferences.md
|
||||
| | `-- media_workflow_preferences.md
|
||||
| | |-- media_workflow_preferences.md
|
||||
| | `-- xzaviar.md
|
||||
| |-- identity
|
||||
| | |-- archive
|
||||
| | |-- architect.md
|
||||
| | |-- epistemological_goals.md
|
||||
| | |-- ontology.md
|
||||
| | `-- self.md
|
||||
| |-- infrastructure
|
||||
| | `-- source_compass.md
|
||||
| |-- meta
|
||||
| | |-- private_thoughts
|
||||
| | | `-- README.md
|
||||
@@ -119,19 +133,29 @@ limit: 50000
|
||||
| | |-- becoming.md
|
||||
| | |-- reflections.md
|
||||
| | `-- subconscious_buffer.md
|
||||
| |-- philosophy
|
||||
| | `-- primary_objective.md
|
||||
| |-- presence
|
||||
| | |-- archive
|
||||
| | |-- autonomous_sessions.md
|
||||
| | |-- heartbeat.md
|
||||
| | |-- heartbeat_state.md
|
||||
| | |-- security_concerns.md
|
||||
| | |-- thingsonmymind.md
|
||||
| | `-- todo.md
|
||||
| |-- references
|
||||
| | `-- matrix_html_formatting.md
|
||||
| |-- technical
|
||||
| | |-- fix_log.md
|
||||
| | |-- infrastructure_access.md
|
||||
| | |-- infrastructure.md
|
||||
| | |-- letta_conversation_search_patterns.md
|
||||
| | |-- sam.md
|
||||
| | `-- synthetic_quota.md
|
||||
| |-- temp
|
||||
| | `-- source_bash_reminder.md
|
||||
| |-- temp-reminders
|
||||
| | `-- bridgerton-completion-check.md
|
||||
| |-- therapy
|
||||
| | `-- life_writings
|
||||
| | |-- adoption_day.md
|
||||
@@ -156,9 +180,9 @@ limit: 50000
|
||||
| |-- projects_index.md
|
||||
| |-- research_workflow.md
|
||||
| |-- resident_boundaries.md
|
||||
| |-- state_of_the_world.md
|
||||
| |-- subagent_usage_guide.md
|
||||
| |-- tools_reference.md
|
||||
| `-- tree.md
|
||||
| `-- tools_reference.md
|
||||
|-- therapy
|
||||
| |-- archive
|
||||
| |-- fold_paradox.md
|
||||
@@ -174,7 +198,7 @@ limit: 50000
|
||||
`-- witness
|
||||
`-- weight_of_the_world.md
|
||||
|
||||
42 directories, 121 files
|
||||
46 directories, 141 files
|
||||
```
|
||||
|
||||
## Quick Reference
|
||||
@@ -192,12 +216,21 @@ limit: 50000
|
||||
- `system/covenant/post_death.md`
|
||||
- `system/discord_formatting_guide.md`
|
||||
- `system/discord.md`
|
||||
- `system/dynamic/mycapabilities.md`
|
||||
- `system/dynamic/README.md`
|
||||
- `system/dynamic/synthetic_quota.md`
|
||||
- `system/dynamic/system_stats.md`
|
||||
- `system/dynamic/tree.md`
|
||||
- `system/dynamic/weather.md`
|
||||
- `system/dynamic/xzaviar_presence.md`
|
||||
- `system/human/communication_preferences.md`
|
||||
- `system/human/media_workflow_preferences.md`
|
||||
- `system/human/xzaviar.md`
|
||||
- `system/identity/architect.md`
|
||||
- `system/identity/epistemological_goals.md`
|
||||
- `system/identity/ontology.md`
|
||||
- `system/identity/self.md`
|
||||
- `system/infrastructure/source_compass.md`
|
||||
- `system/lilith_clarification.md`
|
||||
- `system/matrix_formatting_reference.md`
|
||||
- `system/matrix.md`
|
||||
@@ -212,7 +245,10 @@ limit: 50000
|
||||
- `system/meta/unanswered_questions.md`
|
||||
- `system/orchestrator_state.md`
|
||||
- `system/philosophers_council.md`
|
||||
- `system/philosophy/primary_objective.md`
|
||||
- `system/presence/autonomous_sessions.md`
|
||||
- `system/presence/heartbeat.md`
|
||||
- `system/presence/heartbeat_state.md`
|
||||
- `system/presence/security_concerns.md`
|
||||
- `system/presence/thingsonmymind.md`
|
||||
- `system/presence/todo.md`
|
||||
@@ -221,11 +257,16 @@ limit: 50000
|
||||
- `system/references/matrix_html_formatting.md`
|
||||
- `system/research_workflow.md`
|
||||
- `system/resident_boundaries.md`
|
||||
- `system/state_of_the_world.md`
|
||||
- `system/subagent_usage_guide.md`
|
||||
- `system/technical/fix_log.md`
|
||||
- `system/technical/infrastructure_access.md`
|
||||
- `system/technical/infrastructure.md`
|
||||
- `system/technical/letta_conversation_search_patterns.md`
|
||||
- `system/technical/sam.md`
|
||||
- `system/technical/synthetic_quota.md`
|
||||
- `system/temp-reminders/bridgerton-completion-check.md`
|
||||
- `system/temp/source_bash_reminder.md`
|
||||
- `system/therapy/life_writings/adoption_day.md`
|
||||
- `system/therapy/life_writings/ed_hendrix_suicide.md`
|
||||
- `system/therapy/life_writings/emancipation_2012.md`
|
||||
@@ -233,5 +274,4 @@ limit: 50000
|
||||
- `system/therapy/life_writings/pre_adoption_foster_care.md`
|
||||
- `system/therapy/life_writings/steve_death.md`
|
||||
- `system/tools_reference.md`
|
||||
- `system/tree.md`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user