keshro 0.1.0__tar.gz

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

@@ -0,0 +1,28 @@
+name: Publish CLI
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for PyPI trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

keshro-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.pyc
+.venv/
+.python-version
+.DS_Store
+.pytest_cache/
+dist/
+build/
+*.egg-info/
+.idea/
+.qodo/
+.claude/
+.gstack/
+
+# Keshro daemon context (auto-generated)
+.claude/keshro-context.md
+
+# Keshro agent integrations (generated per-project, not for CLI source)
+.cursorrules
+AGENTS.md

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

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+
+  - repo: https://github.com/omnilib/ufmt
+    rev: v2.8.0
+    hooks:
+      - id: ufmt
+        language_version: python3.10
+        additional_dependencies:
+          - black == 22.6.0
+          - usort == 1.0.4
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.7
+    hooks:
+      - id: ruff
+        args: [--line-length=120, '--ignore=E402,E721,E722,E731,F821', '--fix']

keshro-0.1.0/LICENSE

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

keshro-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: keshro
+Version: 0.1.0
+Summary: The intelligent execution layer for AI agents — CLI interface
+Project-URL: Homepage, https://keshro.com
+Project-URL: Repository, https://github.com/jlewitt1/keshro-cli
+Project-URL: Documentation, https://keshro.com/developers
+Author-email: Josh Lewittes <josh.lewittes@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,cli,coding-agents,execution,planning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: httpx-sse>=0.4
+Requires-Dist: httpx>=0.28
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=0.80
+Requires-Dist: typer>=0.9
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Keshro
+
+Make AI agents execute intelligently. Structured plans, parallel execution, cross-task learning.
+
+```bash
+pip install keshro
+keshro login <token>      # from keshro.com/account
+keshro create             # scan project, generate plan
+keshro continue --all     # agents execute in parallel
+```
+
+## The problem
+
+Your AI agent is great at one task at a time. But real projects have 10-20 tasks with dependencies, shared context, and files that shouldn't be edited by two agents at once.
+
+Run them manually and you're the bottleneck. Run them in parallel and they conflict.
+
+## What Keshro does
+
+1. **Plans the work** — generates a dependency graph with task ordering, file assignments, acceptance criteria, and risk flags
+2. **Runs agents in parallel** — each in an isolated git worktree, respecting dependency order
+3. **Shares context across tasks** — when one agent discovers something, related future tasks inherit that knowledge
+4. **Tracks everything** — git checkpoints before each task, decision audit trails, one-command rollback
+
+## Create from anything
+
+```bash
+keshro create                                         # current directory
+keshro create https://github.com/org/repo             # GitHub repo
+keshro create https://github.com/org/repo/issues/42   # GitHub issue
+keshro create https://linear.app/team/issue/PROJ-123  # Linear issue
+```
+
+Your AI agent scans the project, answers clarifying questions, and generates the plan.
+
+## Execute
+
+Keshro drives the full execution loop — picks up the next task, gives the agent context, validates the result, marks it done, and moves to the next one. You don't manage it.
+
+```bash
+keshro continue                    # execute next task, then the next, then the next
+keshro continue --all              # run everything — parallel agents, each in its own worktree
+keshro continue --all -c 10        # cap at 10 concurrent agents
+keshro continue --dry-run          # preview what would run
+```
+
+## Monitor
+
+```bash
+keshro status                      # progress summary
+keshro status --tui                # live terminal dashboard
+keshro explain <task-id>           # decision audit trail
+keshro rollback <task-id>          # revert to pre-task state
+```
+
+## Works with
+
+Claude Code, Codex, Cursor, Devin, or any AI agent that runs in a terminal.
+
+## License
+
+MIT

keshro-0.1.0/README.md

@@ -0,0 +1,62 @@
+# Keshro
+
+Make AI agents execute intelligently. Structured plans, parallel execution, cross-task learning.
+
+```bash
+pip install keshro
+keshro login <token>      # from keshro.com/account
+keshro create             # scan project, generate plan
+keshro continue --all     # agents execute in parallel
+```
+
+## The problem
+
+Your AI agent is great at one task at a time. But real projects have 10-20 tasks with dependencies, shared context, and files that shouldn't be edited by two agents at once.
+
+Run them manually and you're the bottleneck. Run them in parallel and they conflict.
+
+## What Keshro does
+
+1. **Plans the work** — generates a dependency graph with task ordering, file assignments, acceptance criteria, and risk flags
+2. **Runs agents in parallel** — each in an isolated git worktree, respecting dependency order
+3. **Shares context across tasks** — when one agent discovers something, related future tasks inherit that knowledge
+4. **Tracks everything** — git checkpoints before each task, decision audit trails, one-command rollback
+
+## Create from anything
+
+```bash
+keshro create                                         # current directory
+keshro create https://github.com/org/repo             # GitHub repo
+keshro create https://github.com/org/repo/issues/42   # GitHub issue
+keshro create https://linear.app/team/issue/PROJ-123  # Linear issue
+```
+
+Your AI agent scans the project, answers clarifying questions, and generates the plan.
+
+## Execute
+
+Keshro drives the full execution loop — picks up the next task, gives the agent context, validates the result, marks it done, and moves to the next one. You don't manage it.
+
+```bash
+keshro continue                    # execute next task, then the next, then the next
+keshro continue --all              # run everything — parallel agents, each in its own worktree
+keshro continue --all -c 10        # cap at 10 concurrent agents
+keshro continue --dry-run          # preview what would run
+```
+
+## Monitor
+
+```bash
+keshro status                      # progress summary
+keshro status --tui                # live terminal dashboard
+keshro explain <task-id>           # decision audit trail
+keshro rollback <task-id>          # revert to pre-task state
+```
+
+## Works with
+
+Claude Code, Codex, Cursor, Devin, or any AI agent that runs in a terminal.
+
+## License
+
+MIT

keshro-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "keshro"
+version = "0.1.0"
+description = "The intelligent execution layer for AI agents — CLI interface"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "Josh Lewittes", email = "josh.lewittes@gmail.com"}]
+keywords = ["ai-agents", "execution", "planning", "coding-agents", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.28",
+    "httpx-sse>=0.4",
+    "typer>=0.9",
+    "rich>=13.0",
+    "textual>=0.80",
+]
+
+[project.urls]
+Homepage = "https://keshro.com"
+Repository = "https://github.com/jlewitt1/keshro-cli"
+Documentation = "https://keshro.com/developers"
+
+[project.scripts]
+keshro = "keshro_cli.cli:main"
+kr = "keshro_cli.cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=1.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/keshro_cli"]

keshro-0.1.0/src/keshro_cli/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

keshro-0.1.0/src/keshro_cli/auth.py

@@ -0,0 +1,81 @@
+import httpx
+
+from .client import get_api_url, print_output
+from .config import clear_auth, load_auth, save_auth
+
+
+def _fetch_user(base_url: str, token: str) -> dict:
+    with httpx.Client(base_url=base_url, timeout=30) as client:
+        res = client.get(
+            "/v1/auth/me",
+            headers={"Authorization": f"Bearer {token}"},
+        )
+        res.raise_for_status()
+        return res.json()
+
+
+def cmd_auth_login(
+    api_url: str | None = None,
+    token: str | None = None,
+    json_output: bool = False,
+):
+    base_url = get_api_url(api_url)
+    token = (token or "").strip()
+    if not token:
+        saved_auth = load_auth()
+        saved_token = (saved_auth.get("token") or "").strip()
+        if not saved_token:
+            raise SystemExit(
+                "No saved Keshro session found.\n"
+                "Usage: keshro login <api-token>\n"
+                "You can create or reuse a token from Account -> API in the Keshro app."
+            )
+        try:
+            user = _fetch_user(base_url, saved_token)
+        except httpx.HTTPStatusError as exc:
+            if exc.response.status_code in {401, 403}:
+                raise SystemExit(
+                    "Your saved Keshro session has expired.\n"
+                    "Run: keshro login <api-token>\n"
+                    "You can create or reuse a token from Account -> API in the Keshro app."
+                ) from exc
+            raise
+        if json_output:
+            print_output(
+                {"status": "ok", "user": user["email"], "detail": "already_logged_in"},
+                True,
+            )
+        else:
+            print(f"Already logged in to Keshro as {user['email']}.")
+        return
+
+    user = _fetch_user(base_url, token)
+    body = {"token": token, "user": user}
+    save_auth({"token": body["token"], "user": body["user"], "api_url": base_url})
+    if json_output:
+        print_output({"status": "ok", "user": body["user"]["email"]}, True)
+    else:
+        print(f"Successfully logged in to Keshro as {body['user']['email']}.")
+
+    # Auto-install the supported global integrations.
+    try:
+        from .cli import _install_claude_integration, _install_codex_integration
+
+        claude_target = _install_claude_integration()
+        codex_target = _install_codex_integration()
+        if not json_output:
+            print(f"  ✓ Claude Code: {claude_target}")
+            print(f"  ✓ Codex: {codex_target}")
+            print(
+                "  Run `keshro setup` inside a repo if you also want Cursor repo instructions there."
+            )
+    except Exception:
+        pass  # fail silently
+
+
+def cmd_auth_logout(json_output: bool = False):
+    clear_auth()
+    if json_output:
+        print_output({"status": "ok", "detail": "Local auth cleared."}, True)
+    else:
+        print("Logged out of Keshro.")