Metadata-Version: 2.4
Name: agent-shared-context
Version: 0.1.0
Summary: Personal work orchestrator. One CLI, one main context, many agents.
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: claude-agent-sdk
Requires-Dist: pyyaml
Description-Content-Type: text/markdown

# asc

Agent Shared Context. One CLI, one main context, many agents.

asc is a protocol for agents to share context. When an agent finishes work, it registers a zero-loss brief. Your main thread stays coherent across every tool, every agent, every project.

## Install

```
uv tool install agent-shared-context
```

Requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code).

## The protocol

When you're done with a task, register a zero-loss brief:

```
echo "<zero-loss-brief>" | asc register --author <name>
```

A zero-loss brief is **complete** (every decision, artifact, loose end), **concise** (dense, not long), and **concrete** (specific paths, names, states — actionable).

That's the protocol. Put it in your CLAUDE.md, your Cursor rules, your AGENTS.md. Any agent that can run a shell command can follow it.

## Commands

```
asc where are we                          # talk to the main thread
asc run claude debug the migration issue  # dispatch an agent
asc run --ro claude research k8s networking  # read-only dispatch
echo "<brief>" | asc register --author gemini  # register a handoff
```

## How it works

- **`asc <message>`** — talk to your main thread. Read-only. It knows everything that's been registered and synthesizes it for you.
- **`asc run <agent> <task>`** — dispatch an agent. It works, then registers a zero-loss brief when done.
- **`asc register --author <name>`** — the universal write API. Any agent, any surface, anywhere.

Context is stored as YAML day files in `~/.asc/days/`. Not per-project. Your entire work environment.

## License

MIT
