devin-cli 0.0.1__tar.gz

devin_cli-0.0.1/.github/workflows/pypi-publish.yml

@@ -0,0 +1,31 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+      url: https://pypi.org/p/devin-cli
+    permissions:
+      id-token: write  # Mandatory for trusted publishing
+      contents: read
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.9"
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+    - name: Build binary wheel and source tarball
+      run: python -m build
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

devin_cli-0.0.1/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+ENV/
+
+# Testing
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.pytest_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Config
+.env
+.devbox/
+~/.config/devin/config.json

devin_cli-0.0.1/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [0.1.0] - 2024-05-23
+
+### Added
+- Initial release
+- Session management (create, list, get, terminate)
+- Message sending and history viewing
+- Watch command for live status polling
+- File attachments
+- Knowledge, Playbook, and Secret management commands
+- Shell completion support

devin_cli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Devin CLI Contributors
+
+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.

devin_cli-0.0.1/PKG-INFO

@@ -0,0 +1,255 @@
+Metadata-Version: 2.4
+Name: devin-cli
+Version: 0.0.1
+Summary: Unofficial CLI for Devin AI - The first AI Software Engineer
+Project-URL: Homepage, https://github.com/revanthpobala/devin-cli
+Project-URL: Repository, https://github.com/revanthpobala/devin-cli.git
+Project-URL: Issues, https://github.com/revanthpobala/devin-cli/issues
+Author-email: revanth <revanth@example.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,automation,autonomous,cli,cognition,devin,software-engineer,terminal
+Classifier: Development Status :: 4 - Beta
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer[all]>=0.9.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo.png" alt="Devin CLI Logo" width="300">
+</p>
+
+# Devin CLI (Unofficial) — The Professional Terminal Interface for Devin AI
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/revanthpobala/devin-cli?style=for-the-badge&color=0294DE" alt="License"></a>
+  <a href="https://github.com/revanthpobala/devin-cli/stargazers"><img src="https://img.shields.io/github/stars/revanthpobala/devin-cli?style=for-the-badge&color=FAD000" alt="GitHub stars"></a>
+</p>
+
+> **The first unofficial CLI for the world's first AI Software Engineer.**
+
+Devin CLI is designed for high-velocity engineering teams. It strips away the friction of the web UI, allowing you to orchestrate autonomous agents, manage complex contexts, and automate multi-step development workflows through a robust, terminal-first interface.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+```bash
+# Recommended: Install via pipx for an isolated environment
+pipx install devin-cli 
+
+# Or via standard pip
+pip install devin-cli
+```
+
+### 2. Configuration
+```bash
+devin configure
+# Paste your API token from https://preview.devin.ai/settings
+```
+
+### 3. Your First Session
+```bash
+devin create-session "Identify and fix the race condition in our Redis cache layer"
+devin watch
+```
+
+---
+
+## 🛠 Command Cheat Sheet
+
+### Core Workflow
+| Command | Example Usage |
+| :--- | :--- |
+| **`create-session`** | `devin create-session "Refactor the Auth module"` |
+| **`list-sessions`** | `devin list-sessions --limit 10` |
+| **`watch`** | `devin watch` (Live terminal monitoring) |
+| **`message`** | `devin message "Actually, use the standard library instead of the third-party package"` |
+| **`open`** | `devin open` (Jump to the web UI) |
+| **`status`** | `devin status` (Quick pulse check) |
+| **`terminate`** | `devin terminate` |
+
+### Context & Assets
+| Command | Example Usage |
+| :--- | :--- |
+| **`attach`** | `devin attach ./specs/v2.md "Implement the new billing logic"` |
+| **`upload`** | `devin upload ./db_dump.sql` |
+| **`list-knowledge`** | `devin list-knowledge` |
+
+## 🛠 Detailed Command Reference
+
+Every command supports the `--help` flag for real-time documentation. Below is an exhaustive reference for the core engineering workflow.
+
+<details>
+<summary><b>🚀 create-session</b> — Start a new autonomous agent</summary>
+
+```text
+Usage: devin create-session [OPTIONS] [PROMPT]
+
+Options:
+  -t, --title TEXT          Custom session title
+  -f, --file PATH           Read prompt from file
+  -s, --secret KEY=VALUE    Inject session-specific secrets
+  -k, --knowledge-id TEXT   Knowledge IDs to include
+  --secret-id TEXT          Stored secret IDs to include
+  --max-acu INTEGER         Maximum ACU limit
+  --unlisted                Create unlisted session
+  -i, --idempotent          Idempotent creation
+```
+</details>
+
+<details>
+<summary><b>🔗 chain</b> — Orchestrate multi-step workflows (Beta)</summary>
+
+```text
+Usage: devin chain [OPTIONS] [PROMPT]
+
+Options:
+  --playbooks TEXT          Comma-separated playbook IDs
+  -f, --file PATH           Workflow YAML file
+```
+</details>
+
+<details>
+<summary><b>📎 attach</b> — Upload context and initiate task</summary>
+
+```text
+Usage: devin attach [OPTIONS] FILE PROMPT
+
+Arguments:
+  FILE    File to upload and link (ZIP, PDF, Codebase) [required]
+  PROMPT  Initial instruction for Devin [required]
+```
+</details>
+
+<details>
+<summary><b>📋 list-sessions</b> — Manage your active agents</summary>
+
+```text
+Usage: devin list-sessions [OPTIONS]
+
+Options:
+  --limit INTEGER           Number of sessions to list [default: 10]
+  --json                    Output as machine-readable JSON
+```
+</details>
+
+<details>
+<summary><b>⚙️ configure</b> — Setup your environment</summary>
+
+```text
+Usage: devin configure [OPTIONS]
+
+Initializes your local config with the DEVIN_API_TOKEN.
+```
+</details>
+
+<details>
+<summary><b>👀 watch</b> — Terminal-native live monitoring</summary>
+
+```text
+Usage: devin watch [OPTIONS] [SESSION_ID]
+
+Streams the live logs and terminal output from Devin directly to your console.
+```
+</details>
+
+<details>
+<summary><b>🛑 terminate</b> — Stop an active agent</summary>
+
+```text
+Usage: devin terminate [OPTIONS] [SESSION_ID]
+
+Permanently stops a session and releases all associated resources.
+```
+</details>
+
+<details>
+<summary><b>🌐 open</b> — Jump to the Web UI</summary>
+
+```text
+Usage: devin open [OPTIONS] [SESSION_ID]
+
+Instantly opens the specified session in your default web browser for visual debugging.
+```
+</details>
+
+<details>
+<summary><b>🧠 Knowledge & Playbooks</b> — Advanced CRUD</summary>
+
+| Command | Purpose |
+| :--- | :--- |
+| `list-knowledge` | View all shared organizational context. |
+| `create-knowledge` | Add new documentation or code references. |
+| `update-knowledge` | Refresh existing context. |
+| `list-playbooks` | View all available team playbooks. |
+| `create-playbook` | Design a new standardized workflow. |
+
+</details>
+
+---
+
+## 📟 Integration & Automation
+
+### GitHub Actions Integration
+Devin CLI is designed for CI/CD. Use environment variables to bypass the `configure` step.
+```bash
+# Example GitHub Action Step
+env:
+  DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}
+run: |
+  devin create-session "Review PR #${{ github.event.pull_request.number }}" --unlisted
+```
+
+### Advanced Scripting
+Pipe Devin's intelligence into your existing toolchain.
+```bash
+# Close all blocked sessions
+devin list-sessions --json | jq -r '.[] | select(.status_enum=="blocked") | .session_id' | xargs -I {} devin terminate {}
+```
+
+---
+
+## ⚙️ Engineering Specs
+- **Config Storage**: `~/.config/devin/config.json`
+- **Environment Variables**: `DEVIN_API_TOKEN`, `DEVIN_BASE_URL`
+- **Platform Support**: Linux, macOS, WSL2
+
+---
+
+## 🧪 Developer Hub
+```bash
+# Setup
+pip install -e ".[dev]"
+
+# Test Suite (100% path coverage)
+PYTHONPATH=src pytest
+```
+
+---
+
+## 📄 License
+MIT. **Devin CLI** is an unofficial community project and is not affiliated with Cognition AI.
+
+---
+<!-- SEO Keywords: Devin AI, AI Software Engineer, Autonomous AI Agent, Devin CLI, Terminal AI, Coding Agent, AI Orchestration, Software Engineering Automation, GitHub Actions AI, Cognition AI, Devin API -->

devin_cli-0.0.1/README.md

@@ -0,0 +1,219 @@
+<p align="center">
+  <img src="assets/logo.png" alt="Devin CLI Logo" width="300">
+</p>
+
+# Devin CLI (Unofficial) — The Professional Terminal Interface for Devin AI
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/revanthpobala/devin-cli?style=for-the-badge&color=0294DE" alt="License"></a>
+  <a href="https://github.com/revanthpobala/devin-cli/stargazers"><img src="https://img.shields.io/github/stars/revanthpobala/devin-cli?style=for-the-badge&color=FAD000" alt="GitHub stars"></a>
+</p>
+
+> **The first unofficial CLI for the world's first AI Software Engineer.**
+
+Devin CLI is designed for high-velocity engineering teams. It strips away the friction of the web UI, allowing you to orchestrate autonomous agents, manage complex contexts, and automate multi-step development workflows through a robust, terminal-first interface.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+```bash
+# Recommended: Install via pipx for an isolated environment
+pipx install devin-cli 
+
+# Or via standard pip
+pip install devin-cli
+```
+
+### 2. Configuration
+```bash
+devin configure
+# Paste your API token from https://preview.devin.ai/settings
+```
+
+### 3. Your First Session
+```bash
+devin create-session "Identify and fix the race condition in our Redis cache layer"
+devin watch
+```
+
+---
+
+## 🛠 Command Cheat Sheet
+
+### Core Workflow
+| Command | Example Usage |
+| :--- | :--- |
+| **`create-session`** | `devin create-session "Refactor the Auth module"` |
+| **`list-sessions`** | `devin list-sessions --limit 10` |
+| **`watch`** | `devin watch` (Live terminal monitoring) |
+| **`message`** | `devin message "Actually, use the standard library instead of the third-party package"` |
+| **`open`** | `devin open` (Jump to the web UI) |
+| **`status`** | `devin status` (Quick pulse check) |
+| **`terminate`** | `devin terminate` |
+
+### Context & Assets
+| Command | Example Usage |
+| :--- | :--- |
+| **`attach`** | `devin attach ./specs/v2.md "Implement the new billing logic"` |
+| **`upload`** | `devin upload ./db_dump.sql` |
+| **`list-knowledge`** | `devin list-knowledge` |
+
+## 🛠 Detailed Command Reference
+
+Every command supports the `--help` flag for real-time documentation. Below is an exhaustive reference for the core engineering workflow.
+
+<details>
+<summary><b>🚀 create-session</b> — Start a new autonomous agent</summary>
+
+```text
+Usage: devin create-session [OPTIONS] [PROMPT]
+
+Options:
+  -t, --title TEXT          Custom session title
+  -f, --file PATH           Read prompt from file
+  -s, --secret KEY=VALUE    Inject session-specific secrets
+  -k, --knowledge-id TEXT   Knowledge IDs to include
+  --secret-id TEXT          Stored secret IDs to include
+  --max-acu INTEGER         Maximum ACU limit
+  --unlisted                Create unlisted session
+  -i, --idempotent          Idempotent creation
+```
+</details>
+
+<details>
+<summary><b>🔗 chain</b> — Orchestrate multi-step workflows (Beta)</summary>
+
+```text
+Usage: devin chain [OPTIONS] [PROMPT]
+
+Options:
+  --playbooks TEXT          Comma-separated playbook IDs
+  -f, --file PATH           Workflow YAML file
+```
+</details>
+
+<details>
+<summary><b>📎 attach</b> — Upload context and initiate task</summary>
+
+```text
+Usage: devin attach [OPTIONS] FILE PROMPT
+
+Arguments:
+  FILE    File to upload and link (ZIP, PDF, Codebase) [required]
+  PROMPT  Initial instruction for Devin [required]
+```
+</details>
+
+<details>
+<summary><b>📋 list-sessions</b> — Manage your active agents</summary>
+
+```text
+Usage: devin list-sessions [OPTIONS]
+
+Options:
+  --limit INTEGER           Number of sessions to list [default: 10]
+  --json                    Output as machine-readable JSON
+```
+</details>
+
+<details>
+<summary><b>⚙️ configure</b> — Setup your environment</summary>
+
+```text
+Usage: devin configure [OPTIONS]
+
+Initializes your local config with the DEVIN_API_TOKEN.
+```
+</details>
+
+<details>
+<summary><b>👀 watch</b> — Terminal-native live monitoring</summary>
+
+```text
+Usage: devin watch [OPTIONS] [SESSION_ID]
+
+Streams the live logs and terminal output from Devin directly to your console.
+```
+</details>
+
+<details>
+<summary><b>🛑 terminate</b> — Stop an active agent</summary>
+
+```text
+Usage: devin terminate [OPTIONS] [SESSION_ID]
+
+Permanently stops a session and releases all associated resources.
+```
+</details>
+
+<details>
+<summary><b>🌐 open</b> — Jump to the Web UI</summary>
+
+```text
+Usage: devin open [OPTIONS] [SESSION_ID]
+
+Instantly opens the specified session in your default web browser for visual debugging.
+```
+</details>
+
+<details>
+<summary><b>🧠 Knowledge & Playbooks</b> — Advanced CRUD</summary>
+
+| Command | Purpose |
+| :--- | :--- |
+| `list-knowledge` | View all shared organizational context. |
+| `create-knowledge` | Add new documentation or code references. |
+| `update-knowledge` | Refresh existing context. |
+| `list-playbooks` | View all available team playbooks. |
+| `create-playbook` | Design a new standardized workflow. |
+
+</details>
+
+---
+
+## 📟 Integration & Automation
+
+### GitHub Actions Integration
+Devin CLI is designed for CI/CD. Use environment variables to bypass the `configure` step.
+```bash
+# Example GitHub Action Step
+env:
+  DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}
+run: |
+  devin create-session "Review PR #${{ github.event.pull_request.number }}" --unlisted
+```
+
+### Advanced Scripting
+Pipe Devin's intelligence into your existing toolchain.
+```bash
+# Close all blocked sessions
+devin list-sessions --json | jq -r '.[] | select(.status_enum=="blocked") | .session_id' | xargs -I {} devin terminate {}
+```
+
+---
+
+## ⚙️ Engineering Specs
+- **Config Storage**: `~/.config/devin/config.json`
+- **Environment Variables**: `DEVIN_API_TOKEN`, `DEVIN_BASE_URL`
+- **Platform Support**: Linux, macOS, WSL2
+
+---
+
+## 🧪 Developer Hub
+```bash
+# Setup
+pip install -e ".[dev]"
+
+# Test Suite (100% path coverage)
+PYTHONPATH=src pytest
+```
+
+---
+
+## 📄 License
+MIT. **Devin CLI** is an unofficial community project and is not affiliated with Cognition AI.
+
+---
+<!-- SEO Keywords: Devin AI, AI Software Engineer, Autonomous AI Agent, Devin CLI, Terminal AI, Coding Agent, AI Orchestration, Software Engineering Automation, GitHub Actions AI, Cognition AI, Devin API -->

devin_cli-0.0.1/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "devin-cli"
+version = "0.0.1"
+description = "Unofficial CLI for Devin AI - The first AI Software Engineer"
+readme = "README.md"
+authors = [
+    { name = "revanth", email = "revanth@example.com" },
+]
+license = "MIT"
+keywords = ["devin", "ai", "agent", "software-engineer", "autonomous", "cli", "terminal", "cognition", "automation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "typer[all]>=0.9.0",
+    "httpx>=0.27.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "respx>=0.20.0",
+    "pytest-cov>=4.0.0",
+    "build",
+    "twine",
+]
+
+[project.scripts]
+devin = "devin_cli.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/revanthpobala/devin-cli"
+Repository = "https://github.com/revanthpobala/devin-cli.git"
+Issues = "https://github.com/revanthpobala/devin-cli/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/devin_cli"]

devin_cli-0.0.1/setup.py

@@ -0,0 +1,3 @@
+from setuptools import setup
+
+setup()

devin_cli-0.0.1/src/devin_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

devin_cli-0.0.1/src/devin_cli/api/__init__.py

@@ -0,0 +1 @@
+# API package initialization

devin_cli-0.0.1/src/devin_cli/api/attachments.py

@@ -0,0 +1,12 @@
+from devin_cli.api.client import client
+from pathlib import Path
+
+def upload_file(file_path: str):
+    path = Path(file_path)
+    if not path.exists():
+        raise FileNotFoundError(f"File not found: {file_path}")
+        
+    with open(path, "rb") as f:
+        files = {"file": f}
+        # client.post handles Content-Type removal for files
+        return client.post("attachments", files=files)