goodeye 0.1.0__tar.gz

goodeye-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --group dev --frozen
+
+      - name: Run pre-commit (ruff + pyright)
+        run: uv run pre-commit run --all-files
+
+      - name: Run tests
+        run: uv run pytest

goodeye-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

goodeye-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Environment
+.env
+.env.*
+!.env.example
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+env/
+ENV/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+wheels/
+pip-wheel-metadata/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Type checkers / linters
+.mypy_cache/
+.pyright/
+.ruff_cache/
+
+# Editors
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# uv
+.python-version

goodeye-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: local
+    hooks:
+      - id: pyright
+        name: pyright
+        entry: uv run pyright
+        language: system
+        types: [python]
+        pass_filenames: false

goodeye-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+Thanks for your interest in goodeye-cli.
+
+## Dev setup
+
+Prerequisite: [uv](https://github.com/astral-sh/uv) (Python package manager).
+
+```sh
+git clone https://github.com/Goodeye-Labs/goodeye-cli.git
+cd goodeye-cli
+uv sync --group dev
+uv run pre-commit install
+```
+
+## Run the same checks CI runs
+
+```sh
+uv sync --group dev --frozen
+uv run pre-commit run --all-files
+uv run pytest
+```
+
+## Project layout
+
+- `src/goodeye_cli/` - CLI package
+  - `app.py` - Typer app root
+  - `commands/` - one module per subcommand group
+  - `client.py` - sync HTTP client around the Goodeye REST API
+  - `auth_flows.py` - device-code and magic-auth flows
+  - `config.py` - credentials + client config file I/O
+  - `wire.py` - pydantic wire models for REST responses
+  - `errors.py` - structured CLI errors (mirror server slugs)
+- `tests/` - pytest suite. Network is mocked with `respx`; no live calls.
+
+## Conventions
+
+- Python 3.12+, ruff for lint + format, pyright for types.
+- Line length 100.
+- No em dashes in prose, comments, or docs; use `-`, `:`, or rephrase.
+- Never commit secrets. Tests should mock WorkOS and the Goodeye server.
+- Use obvious placeholders in example tokens (e.g. `good_live_EXAMPLE_...`).
+
+## PR process
+
+1. Branch from `main`.
+2. Keep changes scoped; one logical change per PR.
+3. Ensure `pre-commit` and `pytest` pass locally.
+4. Open a PR against `main`. CI runs ruff + pyright + pytest.
+5. A maintainer will review.
+
+## Reporting security issues
+
+Please do not open public issues for security reports. Email the maintainers
+or use GitHub's private vulnerability reporting feature on this repository.

goodeye-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Goodeye Labs
+
+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.

goodeye-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: goodeye
+Version: 0.1.0
+Summary: Public CLI for Goodeye - manage AI workflow skills from the terminal.
+Project-URL: Repository, https://github.com/Goodeye-Labs/goodeye-cli
+Project-URL: Issues, https://github.com/Goodeye-Labs/goodeye-cli/issues
+Author: Goodeye Labs
+License: MIT License
+        
+        Copyright (c) 2026 Goodeye Labs
+        
+        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.
+License-File: LICENSE
+Keywords: ai,cli,goodeye,mcp,workflows
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic-settings>=2.4
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# goodeye-cli
+
+Command-line client for Goodeye - manage AI workflow skills from the terminal.
+
+Goodeye is an outcome-aligned AI workflow registry: you author skills (markdown
+bodies + manifests) and verifiers that score an AI agent against a measurable
+business outcome. This CLI is wired to the public `/v1/` REST API.
+
+## Install
+
+Requires Python 3.12+.
+
+```sh
+uv tool install goodeye
+# or
+pipx install goodeye
+# or
+pip install goodeye
+```
+
+Once installed, the `goodeye` command is available on your `PATH`.
+
+## Quickstart
+
+```sh
+# Browse the public registry without an account
+goodeye skills list --filter public
+
+# Create an account (emails a one-time code)
+goodeye signup --email you@example.com
+
+# Or log in on a machine with a browser
+goodeye login
+
+# Confirm who you are
+goodeye whoami
+
+# Fetch a public skill as markdown
+goodeye skills get brand-voice > brand-voice.md
+
+# Push a local skill
+goodeye skills push ./my-skill.md --public
+```
+
+### Skill files
+
+`goodeye skills push` reads a markdown file with optional YAML front-matter:
+
+```markdown
+---
+slug: my-skill
+visibility: private
+manifest:
+  title: My skill
+  tags: [data, cleanup]
+---
+
+# Body
+
+The rest of the file is the skill body rendered to the agent at runtime.
+```
+
+`--public` on the command line overrides `visibility`. `--slug` on the command
+line overrides the front-matter `slug`.
+
+## Command reference
+
+```
+goodeye login [--email EMAIL]
+    Without --email: opens the browser for WorkOS device-code approval.
+    With --email: sends a one-time code to your inbox.
+
+goodeye signup --email EMAIL
+    Creates an account and mints your initial API key.
+
+goodeye logout
+    Deletes local credentials. Does not revoke the key server-side; see
+    `goodeye auth list-keys` and `goodeye auth revoke-key`.
+
+goodeye whoami
+    Shows the current user identified by your credentials.
+
+goodeye auth create-key --name NAME [--copy]
+    Mints a new API key. The secret is printed once.
+
+goodeye auth list-keys
+    Table of your API keys (secrets are never returned).
+
+goodeye auth revoke-key <id>
+    Revokes (soft-deletes) a key.
+
+goodeye skills list [--filter all|public|own] [--tag TAG] [--search QUERY] [--json]
+    Paginated listing; auto-follows cursor.
+
+goodeye skills get <id-or-slug> [--version N] [--output PATH] [--json]
+    Emits raw markdown by default; --json returns the envelope.
+
+goodeye skills push <file.md> [--id ID] [--public] [--slug SLUG]
+    Creates or appends a skill version.
+
+goodeye skills set-visibility <id> <private|public>
+goodeye skills delete <id> [--yes]
+
+goodeye design
+    Prints the workflow-designer prompt pack to stdout.
+```
+
+## Configuration
+
+### Credentials
+
+- `GOODEYE_API_KEY` env var (highest precedence).
+- `~/.config/goodeye/credentials.json` (or `$XDG_CONFIG_HOME/goodeye/`).
+
+Credential files are created with mode `0600`.
+
+### Server
+
+- `GOODEYE_SERVER` env var.
+- `server` field inside `credentials.json`.
+- Default: `https://mcp.goodeyelabs.com`.
+
+## REST API, not the CLI
+
+This CLI is pinned to the `/v1/` REST API contract. If you are integrating
+programmatically and want a stable contract, prefer the REST API directly;
+the CLI is a convenience layer over it.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for local-dev setup and the PR
+process. Issues and PRs welcome.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

goodeye-0.1.0/README.md

@@ -0,0 +1,136 @@
+# goodeye-cli
+
+Command-line client for Goodeye - manage AI workflow skills from the terminal.
+
+Goodeye is an outcome-aligned AI workflow registry: you author skills (markdown
+bodies + manifests) and verifiers that score an AI agent against a measurable
+business outcome. This CLI is wired to the public `/v1/` REST API.
+
+## Install
+
+Requires Python 3.12+.
+
+```sh
+uv tool install goodeye
+# or
+pipx install goodeye
+# or
+pip install goodeye
+```
+
+Once installed, the `goodeye` command is available on your `PATH`.
+
+## Quickstart
+
+```sh
+# Browse the public registry without an account
+goodeye skills list --filter public
+
+# Create an account (emails a one-time code)
+goodeye signup --email you@example.com
+
+# Or log in on a machine with a browser
+goodeye login
+
+# Confirm who you are
+goodeye whoami
+
+# Fetch a public skill as markdown
+goodeye skills get brand-voice > brand-voice.md
+
+# Push a local skill
+goodeye skills push ./my-skill.md --public
+```
+
+### Skill files
+
+`goodeye skills push` reads a markdown file with optional YAML front-matter:
+
+```markdown
+---
+slug: my-skill
+visibility: private
+manifest:
+  title: My skill
+  tags: [data, cleanup]
+---
+
+# Body
+
+The rest of the file is the skill body rendered to the agent at runtime.
+```
+
+`--public` on the command line overrides `visibility`. `--slug` on the command
+line overrides the front-matter `slug`.
+
+## Command reference
+
+```
+goodeye login [--email EMAIL]
+    Without --email: opens the browser for WorkOS device-code approval.
+    With --email: sends a one-time code to your inbox.
+
+goodeye signup --email EMAIL
+    Creates an account and mints your initial API key.
+
+goodeye logout
+    Deletes local credentials. Does not revoke the key server-side; see
+    `goodeye auth list-keys` and `goodeye auth revoke-key`.
+
+goodeye whoami
+    Shows the current user identified by your credentials.
+
+goodeye auth create-key --name NAME [--copy]
+    Mints a new API key. The secret is printed once.
+
+goodeye auth list-keys
+    Table of your API keys (secrets are never returned).
+
+goodeye auth revoke-key <id>
+    Revokes (soft-deletes) a key.
+
+goodeye skills list [--filter all|public|own] [--tag TAG] [--search QUERY] [--json]
+    Paginated listing; auto-follows cursor.
+
+goodeye skills get <id-or-slug> [--version N] [--output PATH] [--json]
+    Emits raw markdown by default; --json returns the envelope.
+
+goodeye skills push <file.md> [--id ID] [--public] [--slug SLUG]
+    Creates or appends a skill version.
+
+goodeye skills set-visibility <id> <private|public>
+goodeye skills delete <id> [--yes]
+
+goodeye design
+    Prints the workflow-designer prompt pack to stdout.
+```
+
+## Configuration
+
+### Credentials
+
+- `GOODEYE_API_KEY` env var (highest precedence).
+- `~/.config/goodeye/credentials.json` (or `$XDG_CONFIG_HOME/goodeye/`).
+
+Credential files are created with mode `0600`.
+
+### Server
+
+- `GOODEYE_SERVER` env var.
+- `server` field inside `credentials.json`.
+- Default: `https://mcp.goodeyelabs.com`.
+
+## REST API, not the CLI
+
+This CLI is pinned to the `/v1/` REST API contract. If you are integrating
+programmatically and want a stable contract, prefer the REST API directly;
+the CLI is a convenience layer over it.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for local-dev setup and the PR
+process. Issues and PRs welcome.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

goodeye-0.1.0/pyproject.toml

@@ -0,0 +1,81 @@
+[project]
+name = "goodeye"
+version = "0.1.0"
+description = "Public CLI for Goodeye - manage AI workflow skills from the terminal."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.12"
+authors = [
+  { name = "Goodeye Labs" },
+]
+keywords = ["goodeye", "cli", "ai", "workflows", "mcp"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "typer>=0.12",
+  "httpx>=0.27",
+  "rich>=13",
+  "pydantic>=2.7",
+  "pydantic-settings>=2.4",
+  "pyyaml>=6",
+]
+
+[project.scripts]
+goodeye = "goodeye_cli.__main__:main"
+
+[project.urls]
+Repository = "https://github.com/Goodeye-Labs/goodeye-cli"
+Issues = "https://github.com/Goodeye-Labs/goodeye-cli/issues"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.3",
+  "pytest-asyncio>=0.23",
+  "pytest-cov>=5.0",
+  "respx>=0.21",
+  "ruff>=0.6",
+  "pyright>=1.1.380",
+  "pre-commit>=3.8",
+  "types-pyyaml>=6.0",
+]
+
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/goodeye_cli"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "SIM", "PL", "RUF"]
+# PLR0913: too many args is OK for typer commands.
+# PLC0415: non-top-level imports for lazy loading / testability.
+# PLR2004: magic-number comparisons are common in tests and HTTP-status checks.
+# B008: typer / FastAPI-style default-value calls are idiomatic.
+ignore = ["PLR0913", "PLC0415", "PLR2004", "B008"]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.12"
+typeCheckingMode = "standard"
+reportMissingTypeStubs = false
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"

goodeye-0.1.0/src/goodeye_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Public CLI for Goodeye."""
+
+__version__ = "0.1.0"

goodeye-0.1.0/src/goodeye_cli/__main__.py

@@ -0,0 +1,16 @@
+"""Module entrypoint.
+
+Enables ``python -m goodeye_cli`` and the ``goodeye`` console script.
+"""
+
+from __future__ import annotations
+
+from goodeye_cli.app import app
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

goodeye-0.1.0/src/goodeye_cli/app.py

@@ -0,0 +1,69 @@
+"""Typer app root. Wires subcommands and a global error handler."""
+
+from __future__ import annotations
+
+import sys
+
+import typer
+from rich.console import Console
+
+from goodeye_cli import __version__
+from goodeye_cli.commands import auth as auth_cmds
+from goodeye_cli.commands import design as design_cmd
+from goodeye_cli.commands import login as login_cmd
+from goodeye_cli.commands import logout as logout_cmd
+from goodeye_cli.commands import signup as signup_cmd
+from goodeye_cli.commands import skills as skills_cmds
+from goodeye_cli.commands import whoami as whoami_cmd
+from goodeye_cli.errors import GoodeyeError
+
+app = typer.Typer(
+    name="goodeye",
+    help="Public CLI for Goodeye - manage AI workflow skills from the terminal.",
+    no_args_is_help=True,
+    add_completion=False,
+)
+
+# Top-level commands.
+app.command("login")(login_cmd.login)
+app.command("signup")(signup_cmd.signup)
+app.command("logout")(logout_cmd.logout)
+app.command("whoami")(whoami_cmd.whoami)
+app.command("design")(design_cmd.design)
+
+# Command groups.
+app.add_typer(auth_cmds.app, name="auth", help="Manage API keys.")
+app.add_typer(skills_cmds.app, name="skills", help="Browse and manage skills.")
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"goodeye {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def _root(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the CLI version and exit.",
+    ),
+) -> None:
+    """Global options processed before any subcommand."""
+    # Body intentionally empty; the callback fires only to register the option.
+    _ = version
+
+
+def main() -> None:
+    """Console-script entrypoint with a structured-error-friendly wrapper."""
+    console = Console(stderr=True)
+    try:
+        app()
+    except GoodeyeError as exc:
+        console.print(f"[bold red]{exc.slug}[/bold red]: {exc.message}")
+        if exc.hint:
+            console.print(f"[dim]hint: {exc.hint}[/dim]")
+        sys.exit(1)