eyrie 0.1.0__tar.gz

eyrie-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/

eyrie-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

eyrie-0.1.0/AGENTS.md

@@ -0,0 +1,35 @@
+# AGENTS.md
+
+Eyrie is a Python CLI tool that scaffolds and manages "eyrie" repos — coordination
+workspaces with read-only symlinked sources, curated docs, and multi-agent-platform support.
+
+## Commands
+
+```sh
+uv run eyrie init <name>   # scaffold a new eyrie repo
+uv run eyrie sync          # materialize symlinks + install skills (WIP)
+uv run pytest              # run tests
+uv run pytest tests/test_init.py::TestAgentsMd::test_contains_name  # single test
+```
+
+## Architecture
+
+- `src/eyrie/cli.py` — click CLI entry point (`main` group, `init` and `sync` commands)
+- `src/eyrie/init.py` — scaffold generation logic (`create_scaffold`)
+- `src/eyrie/templates.py` — all template content as string constants
+- `tests/test_init.py` — tests use `click.testing.CliRunner` with the `main` group
+
+## Conventions
+
+- The word "tower" must not appear in code or generated output. Use "eyrie" instead.
+- Templates live as plain string constants in `templates.py`, not as separate files or Jinja2.
+- `eyrie.toml` uses `[eyrie]` as the top-level table (not `[tower]`).
+- Generated eyries use `links/` (read-only, git-ignored) for symlinks to sources.
+- The design doc is at `docs/design.md`.
+
+## Build & dependencies
+
+- Build backend: hatchling with `src/` layout
+- Runtime: click (CLI)
+- Dev: pytest
+- Requires Python >=3.11 (uses stdlib `tomllib`)

eyrie-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabe Schwartz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eyrie-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: eyrie
+Version: 0.1.0
+Summary: A commanding place above your work — scaffold for planning across sources
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Description-Content-Type: text/markdown
+
+# Eyrie
+
+A commanding place above your work — scaffold for planning across sources.
+
+Eyrie creates coordination repos where you (and your agents) can see across
+multiple projects, notes, and sources without reaching down to change them.
+Read-only `links/` point to the real sources; curated `docs/` build persistent
+understanding over time.
+
+## Install
+
+```sh
+uvx eyrie init my-workspace
+```
+
+Or install permanently:
+
+```sh
+uv tool install eyrie
+```
+
+## Usage
+
+### Create a new eyrie
+
+```sh
+eyrie init my-workspace
+```
+
+You'll be asked for a one-sentence description. Eyrie then generates the full
+scaffold: `AGENTS.md`, `docs/`, `links/`, git repo with a pre-commit hook, and
+agent permission rules for OpenCode and Claude Code.
+
+### Add sources
+
+Edit `eyrie.toml`:
+
+```toml
+[[sources]]
+name = "resume"
+path = "~/Projects/resume-cv"
+type = "repo"
+
+[[sources]]
+name = "career-vault"
+path = "~/Documents/ObsidianVaults/Career"
+type = "folder"
+skills = ["vercel-labs/agent-skills/obsidian-cli"]
+
+[[sources]]
+name = "jira"
+type = "remote"
+description = "Team Jira (team.atlassian.net)"
+```
+
+### Sync
+
+```sh
+eyrie sync
+```
+
+This materializes symlinks under `links/`, appends skeleton entries to
+`docs/domain/repos.md` and `sources.md`, and installs any declared skills
+via `npx skills add`.
+
+## How it works
+
+```
+my-workspace/
+├── AGENTS.md        ← agent instructions (generated once, then yours)
+├── CLAUDE.md        ← points to AGENTS.md
+├── eyrie.toml       ← sources, skills config
+├── docs/            ← persistent knowledge (domain, topics, workflow)
+├── links/           ← READ-ONLY symlinks to sources (git-ignored)
+├── output/          ← versioned deliverables
+├── scripts/         ← automation (uv run scripts/foo.py)
+└── scratch/         ← ephemeral work (git-ignored)
+```
+
+The core pattern: **plan here, execute there.** Use the eyrie to understand
+cross-source work, then make changes in the individual source repos.
+
+## Requirements
+
+- Python >= 3.11
+- [uv](https://docs.astral.sh/uv/) (for running and installing)
+- Node.js / npx (optional, for skill installation via `npx skills`)
+
+## License
+
+MIT

eyrie-0.1.0/README.md

@@ -0,0 +1,91 @@
+# Eyrie
+
+A commanding place above your work — scaffold for planning across sources.
+
+Eyrie creates coordination repos where you (and your agents) can see across
+multiple projects, notes, and sources without reaching down to change them.
+Read-only `links/` point to the real sources; curated `docs/` build persistent
+understanding over time.
+
+## Install
+
+```sh
+uvx eyrie init my-workspace
+```
+
+Or install permanently:
+
+```sh
+uv tool install eyrie
+```
+
+## Usage
+
+### Create a new eyrie
+
+```sh
+eyrie init my-workspace
+```
+
+You'll be asked for a one-sentence description. Eyrie then generates the full
+scaffold: `AGENTS.md`, `docs/`, `links/`, git repo with a pre-commit hook, and
+agent permission rules for OpenCode and Claude Code.
+
+### Add sources
+
+Edit `eyrie.toml`:
+
+```toml
+[[sources]]
+name = "resume"
+path = "~/Projects/resume-cv"
+type = "repo"
+
+[[sources]]
+name = "career-vault"
+path = "~/Documents/ObsidianVaults/Career"
+type = "folder"
+skills = ["vercel-labs/agent-skills/obsidian-cli"]
+
+[[sources]]
+name = "jira"
+type = "remote"
+description = "Team Jira (team.atlassian.net)"
+```
+
+### Sync
+
+```sh
+eyrie sync
+```
+
+This materializes symlinks under `links/`, appends skeleton entries to
+`docs/domain/repos.md` and `sources.md`, and installs any declared skills
+via `npx skills add`.
+
+## How it works
+
+```
+my-workspace/
+├── AGENTS.md        ← agent instructions (generated once, then yours)
+├── CLAUDE.md        ← points to AGENTS.md
+├── eyrie.toml       ← sources, skills config
+├── docs/            ← persistent knowledge (domain, topics, workflow)
+├── links/           ← READ-ONLY symlinks to sources (git-ignored)
+├── output/          ← versioned deliverables
+├── scripts/         ← automation (uv run scripts/foo.py)
+└── scratch/         ← ephemeral work (git-ignored)
+```
+
+The core pattern: **plan here, execute there.** Use the eyrie to understand
+cross-source work, then make changes in the individual source repos.
+
+## Requirements
+
+- Python >= 3.11
+- [uv](https://docs.astral.sh/uv/) (for running and installing)
+- Node.js / npx (optional, for skill installation via `npx skills`)
+
+## License
+
+MIT