# Madarx OS V1 Personal Workforce

Madarx OS V1 turns the local runtime into a personal AI workforce for one operator. Work is organized by project, and every project can have its own agents, Disk files, memory, secrets, missions, approvals, and audit trail.

## Projects

Projects are the top-level scope. Planify is seeded as the first project. Use Projects to create additional workspaces for client, product, or internal operations work.

## Disk

Disk is the document space. Files live under `data/disk/<project-slug>/` and are tracked in SQLite. A file can be marked `local_only`; when enabled, non-local engines receive only a redacted marker instead of the file content.

## Team and Marketplace

Marketplace is the catalog. The Agents tab shows reusable agent templates. Team is the management surface for installed agents, their status, memory, permissions, tasks, and activity. V1 seeds five Planify agents: Project Watcher, Personal Assistant, Engineering Lead, Marketing Lead, and Meeting Notes Taker.

## Memory

Memory rows can be scoped to an agent, a project, or globally. Local-only memory is redacted for cloud engines and visible only to local Ollama-style execution.

## Integrations

Google OAuth stores refresh tokens in the secrets vault. Gmail and Calendar read tools are low-risk read tools. Writes stay approval-gated.

## Transcription

Audio uploaded to Disk can be transcribed. Local-only audio is blocked from OpenAI transcription and must use the local transcription path.

## Missions

Missions are repeatable workflows that create heartbeat tasks for the correct installed agent. V1 includes weekly project pulse, draft email response, transcribe and summarize, and deploy preview.

## Audit

Audit search unifies audit logs, tool egress, activity, and artifacts with project and agent filters so the operator can inspect what happened and why.
