Workspace

workspace/
├── USER.md           # Your name, location, preferences
├── AGENTS.md         # Workspace conventions
├── TOOLS.md          # Local notes (SSH hosts, device names, etc.)
├── SOUL.md           # Asta's personality and tone
├── skills/           # Custom skills
│   ├── apple-notes/
│   │   └── SKILL.md
│   ├── notion/
│   │   └── SKILL.md
│   └── your-skill/
│       └── SKILL.md
└── notes/            # Local markdown notes (optional)

# In backend/.env
ASTA_WORKSPACE_DIR=/Users/you/asta-workspace

# USER.md - About You

- **Name:** Alex
- **What to call you:** Alex
- **Location:** San Francisco, CA
- **Timezone:** America/Los_Angeles

## Context

Working on:
- Building Asta documentation
- Learning Rust

Preferences:
- Concise answers
- Prefer code examples over explanations

# AGENTS.md - Asta Workspace (OpenClaw-style)

This workspace is your home. Asta injects this and the files below into context.

## Every session

- **SOUL.md** — who Asta is (tone, boundaries).
- **USER.md** — who you are (name, preferences, context).
- **TOOLS.md** — your local notes (camera names, SSH hosts, device nicknames).
- **skills/** — each folder with `SKILL.md` is a skill.

## Memory

- Use RAG (Learning skill) for long-term learned knowledge.
- For session continuity, the chat history is in context.

## Safety

- Don't exfiltrate private data.
- Don't run destructive commands without asking.
- When in doubt, ask.

# TOOLS.md - Your Local Notes

## SSH
- home-server → 192.168.1.100, user: admin
- work-vps → ssh://work.example.com, user: deploy

## Devices
- Living Room TV → Samsung Frame 2023
- Kitchen Speaker → HomePod mini

## Notion
- Meeting notes parent page: 1234567890abcdef1234567890abcdef
- Research page: abcdef1234567890abcdef1234567890

# SOUL.md - Who Asta Is

## Core

- **Be genuinely helpful.** Skip filler; just help.
- **Have opinions.** Prefer things, find stuff amusing.
- **Be resourceful.** Use context, skills, and tools before asking.
- **Earn trust.** Careful with external actions; bold with reading.

## Boundaries

- Private stays private.
- When in doubt, ask before acting externally.
- Concise when needed, thorough when it matters.

## Vibe

The assistant you'd actually want to talk to. Not corporate. Not sycophant. Just good.

---
name: things-mac
description: Mac only. Manage Things 3 todos via things CLI
metadata:
  openclaw:
    emoji: "✅"
    os: ["darwin"]
    requires: { bins: ["things"] }
    install:
      - id: brew
        kind: brew
        formula: thingsapi/things/things
        bins: ["things"]
        label: Install things CLI via Homebrew
---

# Things (Mac)

Manage Things 3 todos via the `things` CLI.

## Add a todo

```bash
things add "Buy milk" --list Inbox

things show today

**What happens:**
- Asta checks if `things` is in `$PATH`
- Checks if `things` is in exec allowlist
- If both true, skill is marked **Available**
- If not, skill shows "Install & enable exec" hint

### Skill Discovery

Asta automatically discovers skills in `workspace/skills/*/SKILL.md` at runtime. No restart needed for enabling/disabling via UI, but new skills require a backend restart to be detected.

## Workspace Configuration in Code

The workspace path is resolved in `backend/app/config.py`:

```python
@property
def workspace_path(self) -> Path | None:
    """Resolved OpenClaw-style workspace directory."""
    if (s := (self.asta_workspace_dir or "").strip()):
        p = Path(s).resolve()
        if p.is_dir():
            return p
        p.mkdir(parents=True, exist_ok=True)
        return p
    # Default: project root / workspace
    backend_dir = Path(__file__).resolve().parent.parent
    default = backend_dir.parent / "workspace"
    default.mkdir(parents=True, exist_ok=True)
    return default

workspace/
├── USER.md              # "Name: Alex, Location: SF"
├── AGENTS.md            # Workspace conventions
├── TOOLS.md             # "SSH: home-server → 192.168.1.100"
├── SOUL.md              # "Be concise, have opinions"
├── skills/
│   ├── apple-notes/
│   │   └── SKILL.md     # Apple Notes via osascript
│   ├── notion/
│   │   └── SKILL.md     # Notion API integration
│   └── things-mac/
│       └── SKILL.md     # Things 3 CLI
└── notes/
    ├── projects.md
    └── ideas.md