orbit-install 1.0.0__tar.gz

orbit_install-1.0.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+*.duckdb
+*.duckdb.wal
+*.db-journal
+.DS_Store
+CLAUDE.local.md
+.serena/
+.playwright-mcp/

orbit_install-1.0.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: orbit-install
+Version: 1.0.0
+Summary: Bootstrap installer for Orbit - the project manager for Claude Code
+Project-URL: Homepage, https://github.com/tomerbr1/claude-orbit
+Project-URL: Repository, https://github.com/tomerbr1/claude-orbit
+Project-URL: Issues, https://github.com/tomerbr1/claude-orbit/issues
+Author-email: Tomer Brami <tomerbrami@gmail.com>
+License-Expression: MIT
+Keywords: bootstrap,claude,installer,orbit,plugin
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Installation/Setup
+Requires-Python: >=3.11
+Requires-Dist: pyfiglet>=1.0.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# orbit-install
+
+Bootstrap installer for [Orbit](https://github.com/tomerbr1/claude-orbit), the project manager for Claude Code.
+
+## Install
+
+```bash
+uvx orbit-install
+# or
+pipx run orbit-install
+```
+
+The interactive wizard asks which components to install. Default is all:
+
+| Component      | What it does                                                          |
+|----------------|------------------------------------------------------------------------|
+| Plugin         | Registers the orbit plugin with Claude Code (slash commands, MCP, hooks) |
+| Dashboard      | Installs `orbit-dashboard` pip package + launchd/systemd service on port 8787 |
+| orbit-auto CLI | Installs `orbit-auto` for autonomous task execution                   |
+| Statusline     | Wires `~/.claude/settings.json` to run `orbit-statusline` on every prompt |
+| Rules          | Copies rule files into `~/.claude/rules/`                             |
+| User commands  | Copies `/whats-new` and `/optimize-prompt` into `~/.claude/commands/` |
+
+## Non-interactive
+
+```bash
+uvx orbit-install --all                      # install everything
+uvx orbit-install --dashboard --statusline   # install a subset
+uvx orbit-install --update                   # refresh everything
+uvx orbit-install --uninstall                # remove everything (preserves user data)
+```
+
+## Maintainer mode
+
+From a clone of `claude-orbit`:
+
+```bash
+git clone https://github.com/tomerbr1/claude-orbit.git
+cd claude-orbit
+uvx orbit-install --local
+```
+
+`--local` swaps PyPI installs for editable ones and registers the plugin via a local marketplace. Edit files in the clone and see changes live.
+
+## Windows
+
+Windows service registration is not yet supported. The installer will register the plugin, pip-install orbit-auto, and print manual instructions for running the dashboard.
+
+## Uninstall
+
+```bash
+uvx orbit-install --uninstall
+```
+
+Removes: plugin registration, pip packages, service units, settings.json entries. Preserves: `~/.claude/orbit/` (projects), `~/.claude/tasks.db` (task history).
+
+## License
+
+MIT

orbit_install-1.0.0/README.md

@@ -0,0 +1,59 @@
+# orbit-install
+
+Bootstrap installer for [Orbit](https://github.com/tomerbr1/claude-orbit), the project manager for Claude Code.
+
+## Install
+
+```bash
+uvx orbit-install
+# or
+pipx run orbit-install
+```
+
+The interactive wizard asks which components to install. Default is all:
+
+| Component      | What it does                                                          |
+|----------------|------------------------------------------------------------------------|
+| Plugin         | Registers the orbit plugin with Claude Code (slash commands, MCP, hooks) |
+| Dashboard      | Installs `orbit-dashboard` pip package + launchd/systemd service on port 8787 |
+| orbit-auto CLI | Installs `orbit-auto` for autonomous task execution                   |
+| Statusline     | Wires `~/.claude/settings.json` to run `orbit-statusline` on every prompt |
+| Rules          | Copies rule files into `~/.claude/rules/`                             |
+| User commands  | Copies `/whats-new` and `/optimize-prompt` into `~/.claude/commands/` |
+
+## Non-interactive
+
+```bash
+uvx orbit-install --all                      # install everything
+uvx orbit-install --dashboard --statusline   # install a subset
+uvx orbit-install --update                   # refresh everything
+uvx orbit-install --uninstall                # remove everything (preserves user data)
+```
+
+## Maintainer mode
+
+From a clone of `claude-orbit`:
+
+```bash
+git clone https://github.com/tomerbr1/claude-orbit.git
+cd claude-orbit
+uvx orbit-install --local
+```
+
+`--local` swaps PyPI installs for editable ones and registers the plugin via a local marketplace. Edit files in the clone and see changes live.
+
+## Windows
+
+Windows service registration is not yet supported. The installer will register the plugin, pip-install orbit-auto, and print manual instructions for running the dashboard.
+
+## Uninstall
+
+```bash
+uvx orbit-install --uninstall
+```
+
+Removes: plugin registration, pip packages, service units, settings.json entries. Preserves: `~/.claude/orbit/` (projects), `~/.claude/tasks.db` (task history).
+
+## License
+
+MIT

orbit_install-1.0.0/orbit_install/__init__.py

@@ -0,0 +1,3 @@
+"""Orbit installer - bootstrap package for Orbit on Claude Code."""
+
+__version__ = "1.0.0"

orbit_install-1.0.0/orbit_install/__main__.py

@@ -0,0 +1,183 @@
+"""Entry point for `uvx orbit-install` / `pipx run orbit-install`.
+
+Invocation patterns:
+    uvx orbit-install                 # interactive wizard (default)
+    uvx orbit-install --all           # install all components non-interactively
+    uvx orbit-install --dashboard     # install only the dashboard
+    uvx orbit-install --all --no-statusline
+                                      # install everything except the statusline
+    uvx orbit-install --update        # refresh whatever is in state.json
+    uvx orbit-install --uninstall     # remove everything (preserves ~/.claude/orbit/)
+    uvx orbit-install --local         # maintainer mode: editable installs from clone
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from . import __version__, installers, state, ui, wizard
+
+
+DEFAULT_PORT = 8787
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="orbit-install",
+        description="Bootstrap installer for Orbit (project manager for Claude Code).",
+    )
+    p.add_argument(
+        "--version", action="version", version=f"%(prog)s {__version__}"
+    )
+
+    action = p.add_mutually_exclusive_group()
+    action.add_argument(
+        "--all", action="store_true",
+        help="Install all components non-interactively.",
+    )
+    action.add_argument(
+        "--update", action="store_true",
+        help="Update installed components in place (reads state).",
+    )
+    action.add_argument(
+        "--uninstall", action="store_true",
+        help="Remove every component the installer installed.",
+    )
+
+    # Per-component opt-in flags. Any of these triggers non-interactive mode
+    # for exactly the components listed (in combination with --no-* opt-outs).
+    opt_in = p.add_argument_group(
+        "component opt-in (non-interactive)",
+        "Install only the components listed. Can be combined with --no-* to "
+        "exclude specific ones from --all.",
+    )
+    for flag, dest in (
+        ("--plugin", "plugin"),
+        ("--dashboard", "dashboard"),
+        ("--orbit-auto", "orbit_auto"),
+        ("--statusline", "statusline"),
+        ("--rules", "rules"),
+        ("--user-commands", "user_commands"),
+        ("--orbit-db", "orbit_db"),
+    ):
+        opt_in.add_argument(flag, dest=dest, action="store_true")
+
+    opt_out = p.add_argument_group(
+        "component opt-out",
+        "Exclude specific components from --all (e.g. `--all --no-statusline`).",
+    )
+    for flag, dest in (
+        ("--no-plugin", "no_plugin"),
+        ("--no-dashboard", "no_dashboard"),
+        ("--no-orbit-auto", "no_orbit_auto"),
+        ("--no-statusline", "no_statusline"),
+        ("--no-rules", "no_rules"),
+        ("--no-user-commands", "no_user_commands"),
+        ("--no-orbit-db", "no_orbit_db"),
+    ):
+        opt_out.add_argument(flag, dest=dest, action="store_true")
+
+    p.add_argument(
+        "--local", action="store_true",
+        help="Maintainer mode: editable installs + local marketplace from the "
+             "current clone. Auto-detected when run from a repo root.",
+    )
+    p.add_argument(
+        "--no-service", action="store_true",
+        help="Skip launchd/systemd service registration (dashboard will not auto-start).",
+    )
+    p.add_argument(
+        "--port", type=int, default=DEFAULT_PORT,
+        help=f"Dashboard port (default: {DEFAULT_PORT}).",
+    )
+    p.add_argument(
+        "--yes", "-y", action="store_true",
+        help="Skip per-file confirmations (still honors --no-* component opt-outs).",
+    )
+    return p
+
+
+def _explicit_components(args: argparse.Namespace) -> list[str]:
+    """Components explicitly opted in via --plugin / --dashboard / etc."""
+    return [
+        c for c in installers.ALL_COMPONENTS
+        if getattr(args, c, False)
+    ]
+
+
+def _excluded_components(args: argparse.Namespace) -> set[str]:
+    """Components explicitly opted out via --no-*."""
+    return {
+        c for c in installers.ALL_COMPONENTS
+        if getattr(args, f"no_{c}", False)
+    }
+
+
+def _resolve_mode_and_repo(args: argparse.Namespace) -> tuple[str, Path | None]:
+    """Decide pypi vs local mode and locate the repo root if local."""
+    cwd = Path.cwd()
+    marker = cwd / ".claude-plugin" / "plugin.json"
+    if args.local:
+        if not marker.exists():
+            ui.fail(
+                f"--local requires running from a claude-orbit clone "
+                f"(expected {marker} to exist)."
+            )
+        return "local", cwd
+    if marker.exists():
+        # Silent auto-detect: if they're in a clone, assume maintainer workflow.
+        return "local", cwd
+    return "pypi", None
+
+
+def main() -> int:
+    args = build_parser().parse_args()
+    mode, repo_root = _resolve_mode_and_repo(args)
+    state.set_mode(mode)
+    ctx = installers.InstallContext(
+        mode=mode,
+        repo_root=repo_root,
+        skip_service=args.no_service,
+        port=args.port,
+        assume_yes=args.yes,
+    )
+
+    if args.uninstall:
+        installed = state.installed_components() or list(installers.ALL_COMPONENTS)
+        installers.uninstall_components(installed, ctx)
+        return 0
+
+    if args.update:
+        installers.update_all(ctx)
+        return 0
+
+    explicit = _explicit_components(args)
+    excluded = _excluded_components(args)
+
+    if args.all or explicit:
+        base = list(installers.ALL_COMPONENTS) if args.all else explicit
+        selected = [c for c in base if c not in excluded]
+        # statusline needs the orbit-statusline entry point, which ships in the
+        # orbit-dashboard package. Installing statusline without dashboard wires
+        # settings.json to a command that won't resolve. Auto-add dashboard.
+        if "statusline" in selected and "dashboard" not in selected and "dashboard" not in excluded:
+            ui.warn("statusline depends on orbit-dashboard (provides the orbit-statusline entry point). Adding dashboard to the install.")
+            selected.insert(selected.index("statusline"), "dashboard")
+        if not selected:
+            ui.warn("Component selection is empty after applying --no-* flags.")
+            return 0
+        ui.banner()
+        ui.info(f"Installing: {', '.join(c.replace('_', '-') for c in selected)}")
+        installers.install_components(selected, ctx)
+        ui.success_banner(selected)
+        return 0
+
+    # Default: interactive wizard.
+    wizard.run(ctx)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())