Signet Skill

Use Signet for portable agent identity, memory, and secrets management.

Secrets

Retrieve secrets (API keys, tokens) stored in Signet's encrypted vault:

# Get a secret value
signet secret get OPENAI_API_KEY

# List available secrets (names only, never values)
signet secret list

Secrets are encrypted at rest and only accessible to the agent.

Memory

Save and recall information across sessions:

# Save a memory (auto-categorizes and embeds)
signet remember "User prefers dark mode and vim keybindings"

# Search memories
signet recall "user preferences"

# Save with explicit importance
signet remember --importance critical "Never delete the production database"

Memory is persisted in ~/.agents/memory/memories.db and synced across harnesses.

Daemon API

The Signet daemon runs at http://localhost:3850. You can query it directly:

# Check daemon status
curl http://localhost:3850/api/status

# Search memories via API
curl "http://localhost:3850/api/memory/search?q=preferences"

# Get a secret via API (requires local access)
curl http://localhost:3850/api/secrets/OPENAI_API_KEY

Agent Identity Files

Your identity is defined in ~/.agents/:

AGENTS.md - Instructions and capabilities
SOUL.md - Personality and tone
IDENTITY.md - Name and traits
USER.md - User profile and preferences
MEMORY.md - Working memory summary (auto-generated)
agent.yaml - Configuration

Skills

Skills are stored in ~/.agents/skills/ and symlinked to harness directories.

Install skills:

npx skills install <skill-name>

Commands Reference

signet                  # Interactive menu
signet status           # Show status
signet dashboard        # Open web UI
signet secret put NAME  # Store a secret
signet secret get NAME  # Retrieve a secret
signet secret list      # List secret names
signet remember "..."   # Save a memory
signet recall "..."     # Search memories
signet sync             # Sync built-in templates/skills
signet restart          # Restart daemon

2.0 KiB Raw Blame History