taken-cli 0.1.0rc1__tar.gz

taken_cli-0.1.0rc1/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.3
+Name: taken-cli
+Version: 0.1.0rc1
+Summary: Personal dotfile-style CLI for managing AI agent skills
+Author: Pradyoth
+Author-email: Pradyoth <pradyoth.dev@gmail.com>
+License: MIT
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: pydantic>=2.13.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: ruamel-yaml>=0.19.1
+Requires-Dist: typer>=0.24.2
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# taken
+
+> *"A very particular set of skills, acquired over a very long career."*
+
+**taken** is a personal dotfile-style CLI for managing AI agent skills (`SKILL.md` files). Think [chezmoi](https://www.chezmoi.io/), but for agent skills — your skills live in `~/.taken/`, are git-backed, and can be linked into any project on demand.
+
+Fully compatible with the [skills.sh](https://skills.sh) ecosystem (Claude Code, Cursor, OpenAI Codex, and 40+ agents).
+
+---
+
+## Install
+
+```bash
+uv tool install taken
+```
+
+```bash
+pip install taken
+```
+
+---
+
+## Quick Start
+
+**1. Initialize**
+```bash
+taken init
+```
+Sets up `~/.taken/`, prompts for your namespace, creates config and registry.
+
+**2. Create a personal skill**
+```bash
+taken add my-skill
+```
+Scaffolds `~/.taken/skills/<you>/my-skill/SKILL.md` and opens it in your editor.
+
+**3. Adopt an existing skill from a project**
+```bash
+taken add ./agents/my-skill/
+```
+Copies the skill folder into `~/.taken/` and registers it, detecting provenance from skills.sh lock files automatically.
+
+**4. Install a skill from GitHub**
+```bash
+taken install vercel-labs/agent-skills
+taken install vercel-labs/agent-skills/react-best-practices
+taken install https://github.com/vercel-labs/agent-skills
+```
+Interactive fuzzy picker when multiple skills are found. Use `--skill` to install specific ones non-interactively, `--ref` to pin to a branch/tag/SHA, `--pin` to lock the version.
+
+**5. Use a skill in a project**
+```bash
+taken use
+```
+Fuzzy-picks from your registry and copies the skill into `.agents/skills/` in the current project. Records state in `.taken.yaml` (committed to git — no taken dependency needed for teammates).
+
+**6. Push edits back to registry**
+```bash
+taken save
+```
+If you refined a skill while working in a project, `save` promotes those edits back to `~/.taken/` so they propagate to future projects.
+
+**7. Update project skills**
+```bash
+taken update
+```
+Re-copies the latest registry version into the project. Warns before overwriting if local edits are detected.
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `taken init` | First-time setup — creates `~/.taken/`, prompts for namespace |
+| `taken add <skill-name>` | Create a new personal skill, opens in editor |
+| `taken add <path>` | Adopt an existing skill folder into taken management |
+| `taken install <source>` | Install a skill from GitHub |
+| `taken use [namespace/skill]` | Copy a skill from registry into the current project |
+| `taken save [namespace/skill]` | Push project edits back to registry |
+| `taken update [namespace/skill]` | Re-copy latest registry version into project |
+| `taken list` | Show all skills in the registry |
+| `taken remove <namespace/skill>` | Remove a skill from registry |
+
+---
+
+## How It Works
+
+Skills live in `~/.taken/skills/<namespace>/<skill-name>/`. The registry at `~/.taken/registry.yaml` is the single source of truth for provenance — tracking whether a skill was created personally, adopted from a project, or installed from GitHub.
+
+When you run `taken use`, the skill is copied (never symlinked) into `.agents/skills/` and tracked in `.taken.yaml` at the project root. This file is committed to git, making the project self-contained — teammates don't need taken installed to use the skills.
+
+---
+
+## Storage Layout
+
+```
+~/.taken/
+  config.yaml       # username, preferences
+  registry.yaml     # all skills + metadata
+  skills/
+    you/
+      my-skill/
+        SKILL.md
+    vercel-labs/
+      react-best-practices/
+        SKILL.md
+```

taken_cli-0.1.0rc1/README.md

@@ -0,0 +1,108 @@
+# taken
+
+> *"A very particular set of skills, acquired over a very long career."*
+
+**taken** is a personal dotfile-style CLI for managing AI agent skills (`SKILL.md` files). Think [chezmoi](https://www.chezmoi.io/), but for agent skills — your skills live in `~/.taken/`, are git-backed, and can be linked into any project on demand.
+
+Fully compatible with the [skills.sh](https://skills.sh) ecosystem (Claude Code, Cursor, OpenAI Codex, and 40+ agents).
+
+---
+
+## Install
+
+```bash
+uv tool install taken
+```
+
+```bash
+pip install taken
+```
+
+---
+
+## Quick Start
+
+**1. Initialize**
+```bash
+taken init
+```
+Sets up `~/.taken/`, prompts for your namespace, creates config and registry.
+
+**2. Create a personal skill**
+```bash
+taken add my-skill
+```
+Scaffolds `~/.taken/skills/<you>/my-skill/SKILL.md` and opens it in your editor.
+
+**3. Adopt an existing skill from a project**
+```bash
+taken add ./agents/my-skill/
+```
+Copies the skill folder into `~/.taken/` and registers it, detecting provenance from skills.sh lock files automatically.
+
+**4. Install a skill from GitHub**
+```bash
+taken install vercel-labs/agent-skills
+taken install vercel-labs/agent-skills/react-best-practices
+taken install https://github.com/vercel-labs/agent-skills
+```
+Interactive fuzzy picker when multiple skills are found. Use `--skill` to install specific ones non-interactively, `--ref` to pin to a branch/tag/SHA, `--pin` to lock the version.
+
+**5. Use a skill in a project**
+```bash
+taken use
+```
+Fuzzy-picks from your registry and copies the skill into `.agents/skills/` in the current project. Records state in `.taken.yaml` (committed to git — no taken dependency needed for teammates).
+
+**6. Push edits back to registry**
+```bash
+taken save
+```
+If you refined a skill while working in a project, `save` promotes those edits back to `~/.taken/` so they propagate to future projects.
+
+**7. Update project skills**
+```bash
+taken update
+```
+Re-copies the latest registry version into the project. Warns before overwriting if local edits are detected.
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `taken init` | First-time setup — creates `~/.taken/`, prompts for namespace |
+| `taken add <skill-name>` | Create a new personal skill, opens in editor |
+| `taken add <path>` | Adopt an existing skill folder into taken management |
+| `taken install <source>` | Install a skill from GitHub |
+| `taken use [namespace/skill]` | Copy a skill from registry into the current project |
+| `taken save [namespace/skill]` | Push project edits back to registry |
+| `taken update [namespace/skill]` | Re-copy latest registry version into project |
+| `taken list` | Show all skills in the registry |
+| `taken remove <namespace/skill>` | Remove a skill from registry |
+
+---
+
+## How It Works
+
+Skills live in `~/.taken/skills/<namespace>/<skill-name>/`. The registry at `~/.taken/registry.yaml` is the single source of truth for provenance — tracking whether a skill was created personally, adopted from a project, or installed from GitHub.
+
+When you run `taken use`, the skill is copied (never symlinked) into `.agents/skills/` and tracked in `.taken.yaml` at the project root. This file is committed to git, making the project self-contained — teammates don't need taken installed to use the skills.
+
+---
+
+## Storage Layout
+
+```
+~/.taken/
+  config.yaml       # username, preferences
+  registry.yaml     # all skills + metadata
+  skills/
+    you/
+      my-skill/
+        SKILL.md
+    vercel-labs/
+      react-best-practices/
+        SKILL.md
+```

taken_cli-0.1.0rc1/pyproject.toml

@@ -0,0 +1,119 @@
+[project]
+name = "taken-cli"
+version = "0.1.0rc1"
+description = "Personal dotfile-style CLI for managing AI agent skills"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Pradyoth", email = "pradyoth.dev@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "inquirerpy>=0.3.4",
+    "pydantic>=2.13.3",
+    "rich>=15.0.0",
+    "ruamel-yaml>=0.19.1",
+    "typer>=0.24.2",
+]
+
+[project.scripts]
+taken = "taken.main:main"
+
+[build-system]
+requires = ["uv_build>=0.10.9,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "taken"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.6.0",
+    "pyright>=1.1.409",
+    "ruff>=0.15.12",
+]
+test = [
+    "anyio>=4.0",
+    "polyfactory>=3.3.0",
+    "pytest>=9.0.3",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+anyio_mode = "asyncio"
+
+[tool.pyright]
+include = ["src", "tests"]
+venvPath = "."
+venv = ".venv"
+pythonVersion = "3.14"
+typeCheckingMode = "strict"
+reportMissingImports = true
+useLibraryCodeForTypes = true
+reportInvalidTypeForm = true
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+# Allow autofix behavior
+fix = true
+unsafe-fixes = false
+
+# Exclude files and directories
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+    "migrations",
+    ".agents",
+]
+
+[tool.ruff.lint]
+select = [
+    "E", # pycodestyle errors
+    "F", # pyflakes
+    "UP", # pyupgrade
+    "B", # flake8-bugbear
+    "SIM", # flake8-simplify
+    "I", # isort
+    "RUF", # Ruff-specific rules
+    "C90", # McCabe complexity
+    "ARG", # unused arguments
+]
+
+# Ignore specific rules
+ignore = [
+    "E501", # Line too long (handled by formatter)
+]
+
+[tool.flake8]
+ignore = ["E501"]
+max-line-length = 120
+
+[tool.ruff.lint.pydocstyle]
+convention = "google" # Use Google-style docstrings
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

taken_cli-0.1.0rc1/src/taken/commands/add.py

@@ -0,0 +1,211 @@
+import re
+from datetime import datetime
+from pathlib import Path
+
+import typer
+from rich.panel import Panel
+
+from taken.core import paths
+from taken.core.config import is_config_exists, read_config
+from taken.core.editor import open_in_editor
+from taken.core.registry import read_registry, write_registry
+from taken.core.skills import (
+    adopt_skill,
+    is_path_argument,
+    lookup_lock_entry,
+    scaffold_skill,
+)
+from taken.models.config import TakenConfig
+from taken.models.registry import RegistryEntry, SkillSource
+from taken.utils.console import console, err_console
+
+_VALID_NAME = re.compile(r"^[a-zA-Z0-9][a-zA-Z0-9_-]*$")
+
+
+def add(
+    skill_or_path: str = typer.Argument(..., help="Skill name to create, or path to existing skill folder to adopt"),
+) -> None:
+    """Add a new personal skill or adopt an existing skill into taken management."""
+    if not is_config_exists(paths.TAKEN_HOME):
+        err_console.print(
+            Panel(
+                "Taken is not initialized. Run [bold]taken init[/bold] to get started.",
+                title="[red]Not Initialized[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    config = read_config(paths.TAKEN_HOME)
+
+    if is_path_argument(skill_or_path):
+        _adopt_mode(skill_or_path, config)
+    else:
+        _create_mode(skill_or_path, config)
+
+
+def _create_mode(name: str, config: TakenConfig) -> None:
+    if "/" in name:
+        err_console.print(
+            Panel(
+                f"Skill name must not contain a namespace. Got: [bold]{name}[/bold]\n"
+                f"Your namespace [bold]{config.username}[/bold] is added automatically.\n"
+                "Example: [bold]taken add my-skill[/bold]",
+                title="[red]Invalid Skill Name[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    if not _VALID_NAME.match(name):
+        err_console.print(
+            Panel(
+                f"[bold]{name}[/bold] is not a valid skill name.\n"
+                "Use lowercase letters, numbers, hyphens, and underscores only.\n"
+                "Must start with a letter or number.",
+                title="[red]Invalid Skill Name[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    registry = read_registry(paths.TAKEN_HOME)
+    full_name = f"{config.username}/{name}"
+
+    if registry.exists(full_name):
+        err_console.print(
+            Panel(
+                f"Skill [bold]{full_name}[/bold] is already in your registry.\nUse [bold]taken list[/bold] to see it.",
+                title="[red]Already Exists[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    try:
+        skill_md = scaffold_skill(config.username, name, paths.TAKEN_HOME)
+    except FileExistsError:
+        err_console.print(
+            Panel(
+                f"Skill directory already exists on disk but is not in the registry.\n"
+                f"Path: [dim]{paths.TAKEN_HOME}/skills/{config.username}/{name}[/dim]\n"
+                "Run [bold]taken doctor[/bold] to repair registry drift.",
+                title="[red]Directory Conflict[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1) from None
+
+    now = datetime.now()
+    entry = RegistryEntry(
+        namespace=config.username,
+        name=name,
+        source=SkillSource.PERSONAL,
+        version="1",
+        created_at=now,
+        updated_at=now,
+    )
+    registry.add(entry)
+    write_registry(registry, paths.TAKEN_HOME)
+
+    console.print(
+        Panel(
+            f"[green]✓[/green] Created [bold]{full_name}[/bold]\n"
+            f"[green]✓[/green] Registered as [bold]personal[/bold] skill\n\n"
+            f"[dim]Opening editor…[/dim]",
+            title="[green]Skill Created[/green]",
+            border_style="green",
+            padding=(1, 2),
+        )
+    )
+
+    open_in_editor(skill_md)
+
+
+def _adopt_mode(path_str: str, config: TakenConfig) -> None:
+    source_dir = Path(path_str).resolve()
+
+    if not source_dir.is_dir():
+        err_console.print(
+            Panel(
+                f"[bold]{path_str}[/bold] is not a directory.",
+                title="[red]Invalid Path[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    name = source_dir.name
+    lock_entry = lookup_lock_entry(name, Path.cwd())
+
+    if lock_entry is not None:
+        namespace = lock_entry.source.split("/")[0]
+        source = SkillSource.NPX
+        repo = lock_entry.source
+        version = lock_entry.ref
+        source_url = lock_entry.source_url
+        skill_path = lock_entry.skill_path
+        skill_folder_hash = lock_entry.skill_folder_hash
+    else:
+        namespace = config.username
+        source = SkillSource.PERSONAL
+        repo = None
+        version = None
+        source_url = None
+        skill_path = None
+        skill_folder_hash = None
+
+    registry = read_registry(paths.TAKEN_HOME)
+    full_name = f"{namespace}/{name}"
+
+    if registry.exists(full_name):
+        err_console.print(
+            Panel(
+                f"Skill [bold]{full_name}[/bold] is already in your registry.\nUse [bold]taken list[/bold] to see it.",
+                title="[red]Already Exists[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+    try:
+        adopt_skill(source_dir, namespace, name, paths.TAKEN_HOME)
+    except FileExistsError:
+        err_console.print(
+            Panel(
+                f"Skill directory already exists at [dim]{paths.TAKEN_HOME}/skills/{namespace}/{name}[/dim]\n"
+                "Run [bold]taken doctor[/bold] to repair registry drift.",
+                title="[red]Directory Conflict[/red]",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1) from None
+
+    now = datetime.now()
+    entry = RegistryEntry(
+        namespace=namespace,
+        name=name,
+        source=source,
+        repo=repo,
+        version=version,
+        installed_at=now if source == SkillSource.NPX else None,
+        created_at=now if source == SkillSource.PERSONAL else None,
+        updated_at=now,
+        source_url=source_url,
+        skill_path=skill_path,
+        skill_folder_hash=skill_folder_hash,
+    )
+    registry.add(entry)
+    write_registry(registry, paths.TAKEN_HOME)
+
+    source_detail = f" ({repo})" if repo else ""
+    console.print(
+        Panel(
+            f"[green]✓[/green] Adopted [bold]{name}[/bold] → [bold]{full_name}[/bold]\n"
+            f"[green]✓[/green] Source: [bold]{source.value}[/bold]{source_detail}\n\n"
+            f"[dim]Copied to ~/.taken/skills/{namespace}/{name}/[/dim]",
+            title="[green]Skill Adopted[/green]",
+            border_style="green",
+            padding=(1, 2),
+        )
+    )