85 lines
2.0 KiB
Markdown
85 lines
2.0 KiB
Markdown
# Signet Skill
|
|
|
|
Use Signet for portable agent identity, memory, and secrets management.
|
|
|
|
## Secrets
|
|
|
|
Retrieve secrets (API keys, tokens) stored in Signet's encrypted vault:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
npx skills install <skill-name>
|
|
```
|
|
|
|
## Commands Reference
|
|
|
|
```bash
|
|
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
|
|
```
|