orchid-cli 1.0.0__tar.gz → 1.0.2__tar.gz

orchid_cli-1.0.2/CHANGELOG.md

@@ -0,0 +1,27 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.2 (2026-04-13)
+
+### Bug Fixes
+
+- Removing external dependencies and improving error handling and final outcome for the user.
+  ([`2ebc6ef`](https://github.com/gadz82/orchid-cli/commit/2ebc6efb8f96e047a3dc649710967d4aece64ab4))
+
+
+## v1.0.1 (2026-04-13)
+
+### Bug Fixes
+
+- Orchid-cli package description and readme update.
+  ([`5055129`](https://github.com/gadz82/orchid-cli/commit/505512906fc9b6d88752940dd1c9b24a2eec8f0d))
+
+
+## v1.0.0 (2026-04-13)
+
+- Initial Release
+
+## v1.0.0 (2026-04-10)
+
+- Initial Release

orchid_cli-1.0.2/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: orchid-cli
+Version: 1.0.2
+Summary: Orchid CLI — command-line interface for the Orchid agent framework
+Project-URL: Homepage, https://github.com/gadz82/orchid
+Project-URL: Repository, https://github.com/gadz82/orchid
+Project-URL: Documentation, https://github.com/gadz82/orchid#readme
+Project-URL: Issues, https://github.com/gadz82/orchid/issues
+Project-URL: Changelog, https://github.com/gadz82/orchid/blob/main/CHANGELOG.md
+Author-email: Francesco Marchesini <gadz82@users.noreply.github.com>
+Maintainer-email: Francesco Marchesini <gadz82@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,cli,langgraph,llm,mcp,multi-agent,orchestration,rag
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: orchid-ai>=1.2.0
+Requires-Dist: pydantic-settings>=2.7.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: gitlint>=0.19.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="icon.svg" alt="Orchid" width="80" />
+</p>
+
+<h1 align="center">Orchid CLI</h1>
+
+Command-line interface for the [Orchid](https://github.com/gadz82/orchid) multi-agent AI framework.
+
+Provides terminal access to all chat operations, configuration validation, RAG indexing, and Claude Code skill generation. Mirrors the full functionality of [orchid-api](../orchid-api) but runs locally with no server, Docker, or external database required (defaults to SQLite).
+
+## Installation
+
+```bash
+pip install orchid-ai orchid-cli
+```
+
+The `orchid` command is available after installation.
+
+## Quick Start
+
+```bash
+# Validate config:
+orchid config validate agents.yaml
+
+# Start an interactive chat session:
+orchid chat interactive -c orchid.yml
+
+# Send a single message:
+orchid chat create -c orchid.yml -t "My Chat"
+orchid chat send <chat_id> "Hello!" -c orchid.yml
+```
+
+## Commands
+
+### Chat Management
+
+```bash
+# Create a new chat session
+orchid chat create -c orchid.yml -t "My Chat Title"
+
+# List all chat sessions
+orchid chat list -c orchid.yml
+
+# Show message history
+orchid chat history <chat_id> -c orchid.yml
+orchid chat history <chat_id> -c orchid.yml --limit 10
+
+# Rename a chat
+orchid chat rename <chat_id> "New Title" -c orchid.yml
+
+# Share a chat (promote RAG data to user scope)
+orchid chat share <chat_id> -c orchid.yml
+
+# Delete a chat
+orchid chat delete <chat_id> -c orchid.yml
+orchid chat delete <chat_id> -c orchid.yml --force
+```
+
+Chat IDs support **prefix matching** -- type the first few characters of the UUID.
+
+### Messaging
+
+```bash
+# Send a single message and print the response
+orchid chat send <chat_id> "What is LangGraph?" -c orchid.yml
+
+# Override the LLM model
+orchid chat send <chat_id> "Explain RAG" -c orchid.yml -m ollama/llama3.2
+```
+
+### Interactive Mode
+
+```bash
+# Start a new interactive session
+orchid chat interactive -c orchid.yml
+
+# Resume an existing chat
+orchid chat interactive <chat_id> -c orchid.yml
+```
+
+Slash commands available inside interactive mode:
+
+| Command | Purpose |
+|---------|---------|
+| `/list` | List all chat sessions |
+| `/switch <id>` | Switch to another chat |
+| `/new [title]` | Create a new chat |
+| `/history` | Show last 20 messages |
+| `/rename <title>` | Rename current chat |
+| `/quit` | Exit interactive mode |
+
+### Configuration
+
+```bash
+# Validate an agents.yaml file
+orchid config validate path/to/agents.yaml
+```
+
+### RAG Indexing
+
+```bash
+# Seed the vector store with static data
+orchid index seed -c orchid.yml
+
+# Seed for a specific tenant
+orchid index seed -c orchid.yml --tenant my-tenant
+```
+
+### Skill Generation (Claude Code)
+
+Generate [Claude Code skills](https://docs.anthropic.com/en/docs/claude-code/skills) from your Orchid agent configuration. Each agent and orchestrator skill becomes a Claude Code skill directory with a `SKILL.md` file.
+
+```bash
+# Generate skills for all agents and orchestrator skills
+orchid skill generate path/to/agents.yaml
+
+# Custom output directory
+orchid skill generate path/to/agents.yaml -o .claude/skills
+
+# Generate only specific agents/skills
+orchid skill generate path/to/agents.yaml --include basketball,psychologist
+
+# Overwrite existing skill directories
+orchid skill generate path/to/agents.yaml --overwrite
+
+# Create a zip archive for upload
+orchid skill generate path/to/agents.yaml --zip
+```
+
+**What gets converted:**
+
+| Orchid Concept | Claude Code Skill |
+|---|---|
+| Agent prompt | Core SKILL.md instructions |
+| Agent description | Skill frontmatter description |
+| Built-in tools | Executable Python scripts in `scripts/` |
+| Agent skills (workflows) | Step-by-step workflow instructions with script commands |
+| Orchestrator skills | Multi-agent workflow skill |
+| MCP servers | Noted as runtime-only (not portable) |
+| RAG context | Noted as runtime-only (not portable) |
+| Guardrails (global + per-agent) | Input/output rules section with actions and config |
+
+Each agent skill includes a `scripts/` folder with standalone Python scripts that Claude Code can execute directly. Tools from the same source module are grouped into a single script file with a CLI wrapper that accepts `--arg value` arguments.
+
+## Configuration
+
+The `--config` (`-c`) flag points to an `orchid.yml` file:
+
+```yaml
+llm:
+  model: ollama/llama3.2
+agents:
+  config_path: agents.yaml
+rag:
+  vector_backend: null      # no Qdrant needed for basic usage
+storage:
+  class: orchid.persistence.sqlite.SQLiteChatStorage
+  dsn: ~/.orchid/chats.db
+```
+
+### Defaults
+
+| Parameter | Default | Env Override |
+|-----------|---------|-------------|
+| LLM model | `ollama/llama3.2` | `LITELLM_MODEL` |
+| Vector backend | `qdrant` | `VECTOR_BACKEND` |
+| Storage class | `orchid.persistence.sqlite.SQLiteChatStorage` | `CHAT_STORAGE_CLASS` |
+| Storage DSN | `~/.orchid/chats.db` | `CHAT_DB_DSN` |
+
+Chat data is stored in SQLite at `~/.orchid/chats.db` by default. The directory is created automatically on first run.
+
+## Prerequisites
+
+- Python 3.11+
+- Ollama running locally (for local LLM models): `ollama pull llama3.2`
+
+## Architecture
+
+```
+orchid_cli/
+  main.py          Typer entry point -- registers sub-commands
+  bootstrap.py     Shared startup: load config, build graph, init storage
+  commands/
+    chat.py        Full CRUD + messaging + interactive mode
+    config.py      Validate agents.yaml
+    index.py       Seed RAG vector store
+    skill.py       Generate Claude Code skills from agents.yaml
+```
+
+The CLI is a thin layer that calls `orchid` SDK functions and displays results via Rich.
+
+## Development
+
+```bash
+pip install -e ../orchid -e ".[dev]"
+orchid config validate ../examples/basketball/agents.yaml
+```
+
+## Testing
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -x
+ruff check orchid_cli/
+```
+
+## License
+
+MIT -- see [LICENSE](LICENSE).

{orchid_cli-1.0.0 → orchid_cli-1.0.2}/README.md

@@ -4,7 +4,7 @@
 
 <h1 align="center">Orchid CLI</h1>
 
-Command-line interface for the [Orchid](../orchid) multi-agent AI framework.
+Command-line interface for the [Orchid](https://github.com/gadz82/orchid) multi-agent AI framework.
 
 Provides terminal access to all chat operations, configuration validation, RAG indexing, and Claude Code skill generation. Mirrors the full functionality of [orchid-api](../orchid-api) but runs locally with no server, Docker, or external database required (defaults to SQLite).
 

{orchid_cli-1.0.0 → orchid_cli-1.0.2}/pyproject.toml

@@ -1,8 +1,40 @@
 [project]
 name = "orchid-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "Orchid CLI — command-line interface for the Orchid agent framework"
+readme = "README.md"
+license = "MIT"
 requires-python = ">=3.11"
+authors = [
+    { name = "Francesco Marchesini", email = "gadz82@users.noreply.github.com" },
+]
+maintainers = [
+    { name = "Francesco Marchesini", email = "gadz82@users.noreply.github.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "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 :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Environment :: Console",
+    "Typing :: Typed",
+]
+keywords = [
+    "ai",
+    "agents",
+    "multi-agent",
+    "cli",
+    "langgraph",
+    "rag",
+    "mcp",
+    "llm",
+    "orchestration",
+]
 dependencies = [
     "orchid-ai>=1.2.0",
     "typer>=0.12.0",
@@ -16,6 +48,13 @@ dependencies = [
 [project.scripts]
 orchid = "orchid_cli.main:app"
 
+[project.urls]
+Homepage = "https://github.com/gadz82/orchid"
+Repository = "https://github.com/gadz82/orchid"
+Documentation = "https://github.com/gadz82/orchid#readme"
+Issues = "https://github.com/gadz82/orchid/issues"
+Changelog = "https://github.com/gadz82/orchid/blob/main/CHANGELOG.md"
+
 [project.optional-dependencies]
 dev = [
     "pytest>=8.0",

orchid_cli-1.0.2/tests/fixtures/fake_tools_dates.py

@@ -0,0 +1,39 @@
+"""Fake date tools for skill generation tests — no external dependencies."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+
+def format_date(value: str, fmt: str = "%Y-%m-%d") -> str:
+    """
+    Parse a date string and re-format it.
+
+    Parameters
+    ----------
+    value : str
+        Input date string (e.g. ``"2025-03-15T10:30:00Z"``).
+    fmt : str
+        Output format (``strftime`` pattern).  Default: ``"%Y-%m-%d"``.
+
+    Returns
+    -------
+    str
+        Formatted date string.
+    """
+    formats_to_try = [
+        "%Y-%m-%dT%H:%M:%SZ",
+        "%Y-%m-%dT%H:%M:%S",
+        "%Y-%m-%dT%H:%M:%S%z",
+        "%Y-%m-%d %H:%M:%S",
+        "%Y-%m-%d",
+        "%d/%m/%Y",
+        "%m/%d/%Y",
+    ]
+    for parse_fmt in formats_to_try:
+        try:
+            dt = datetime.strptime(value, parse_fmt)
+            return dt.strftime(fmt)
+        except ValueError:
+            continue
+    raise ValueError(f"Could not parse date '{value}' with any known format")

orchid_cli-1.0.2/tests/fixtures/fake_tools_math.py

@@ -0,0 +1,24 @@
+"""Fake math tools for skill generation tests — no external dependencies."""
+
+from __future__ import annotations
+
+
+def calculate_completion_rate(enrolled: int, completed: int) -> float:
+    """
+    Calculate course completion percentage.
+
+    Parameters
+    ----------
+    enrolled : int
+        Total number of enrolled users.
+    completed : int
+        Number of users who completed the course.
+
+    Returns
+    -------
+    float
+        Completion rate as a percentage (0.0–100.0), rounded to 1 decimal.
+    """
+    if enrolled <= 0:
+        return 0.0
+    return round((completed / enrolled) * 100, 1)

{orchid_cli-1.0.0 → orchid_cli-1.0.2}/tests/test_commands_skill.py

@@ -74,7 +74,7 @@ class TestSkillGenerate:
         config = _minimal_config(
             tools={
                 "my_tool": {
-                    "handler": "orchid_ai.tools.math.calculate_completion_rate",
+                    "handler": "tests.fixtures.fake_tools_math.calculate_completion_rate",
                     "description": "Calculate completion rate",
                 },
             },
@@ -103,7 +103,7 @@ class TestSkillGenerate:
         config = _minimal_config(
             tools={
                 "calc_rate": {
-                    "handler": "orchid_ai.tools.math.calculate_completion_rate",
+                    "handler": "tests.fixtures.fake_tools_math.calculate_completion_rate",
                     "description": "Calc rate",
                 },
             },
@@ -113,7 +113,7 @@ class TestSkillGenerate:
         out = str(tmp_path / "skills")
         runner.invoke(app, ["skill", "generate", cfg_path, "-o", out])
         os.unlink(cfg_path)
-        script = tmp_path / "skills" / "helper" / "scripts" / "math.py"
+        script = tmp_path / "skills" / "helper" / "scripts" / "fake_tools_math.py"
         assert script.exists()
         # Run the script
         result = subprocess.run(
@@ -129,7 +129,7 @@ class TestSkillGenerate:
         config = _minimal_config(
             tools={
                 "calc_rate": {
-                    "handler": "orchid_ai.tools.math.calculate_completion_rate",
+                    "handler": "tests.fixtures.fake_tools_math.calculate_completion_rate",
                     "description": "Calc rate",
                 },
             },
@@ -139,7 +139,7 @@ class TestSkillGenerate:
         out = str(tmp_path / "skills")
         runner.invoke(app, ["skill", "generate", cfg_path, "-o", out])
         os.unlink(cfg_path)
-        script = tmp_path / "skills" / "helper" / "scripts" / "math.py"
+        script = tmp_path / "skills" / "helper" / "scripts" / "fake_tools_math.py"
         result = subprocess.run(
             [sys.executable, str(script), "--help"],
             capture_output=True,
@@ -153,7 +153,7 @@ class TestSkillGenerate:
         config = _minimal_config(
             tools={
                 "calc_rate": {
-                    "handler": "orchid_ai.tools.math.calculate_completion_rate",
+                    "handler": "tests.fixtures.fake_tools_math.calculate_completion_rate",
                     "description": "Calc rate",
                 },
             },
@@ -164,7 +164,7 @@ class TestSkillGenerate:
         runner.invoke(app, ["skill", "generate", cfg_path, "-o", out])
         os.unlink(cfg_path)
         content = (tmp_path / "skills" / "helper" / "SKILL.md").read_text()
-        assert "scripts/math.py" in content
+        assert "scripts/fake_tools_math.py" in content
         assert "CLAUDE_SKILL_DIR" in content
         assert "allowed-tools" in content
 
@@ -235,7 +235,7 @@ class TestSkillGenerate:
         """Agent-level skills appear as workflows in SKILL.md."""
         config = _minimal_config(
             tools={
-                "step_a": {"handler": "orchid_ai.tools.math.calculate_completion_rate", "description": "Step A"},
+                "step_a": {"handler": "tests.fixtures.fake_tools_math.calculate_completion_rate", "description": "Step A"},
             },
         )
         config["agents"]["helper"]["tools"] = ["step_a"]
@@ -255,7 +255,7 @@ class TestSkillGenerate:
         assert "my_workflow" in content
         assert "A two-step workflow" in content
         # Workflow steps should reference scripts
-        assert "scripts/math.py" in content
+        assert "scripts/fake_tools_math.py" in content
 
     def test_mcp_servers_noted(self, tmp_path):
         """MCP servers are documented as non-portable integrations."""
@@ -279,8 +279,8 @@ class TestSkillGenerate:
         """Tools from the same module share one script file."""
         config = _minimal_config(
             tools={
-                "tool_a": {"handler": "orchid_ai.tools.math.calculate_completion_rate", "description": "A"},
-                "tool_b": {"handler": "orchid_ai.tools.dates.format_date", "description": "B"},
+                "tool_a": {"handler": "tests.fixtures.fake_tools_math.calculate_completion_rate", "description": "A"},
+                "tool_b": {"handler": "tests.fixtures.fake_tools_dates.format_date", "description": "B"},
             },
         )
         config["agents"]["helper"]["tools"] = ["tool_a", "tool_b"]
@@ -290,8 +290,8 @@ class TestSkillGenerate:
         os.unlink(cfg_path)
         scripts_dir = tmp_path / "skills" / "helper" / "scripts"
         # Two different modules -> two script files
-        assert (scripts_dir / "math.py").exists()
-        assert (scripts_dir / "dates.py").exists()
+        assert (scripts_dir / "fake_tools_math.py").exists()
+        assert (scripts_dir / "fake_tools_dates.py").exists()
 
     def test_generates_zip_archive(self, tmp_path):
         """--zip flag creates a zip archive of all generated skills."""

orchid_cli-1.0.0/CHANGELOG.md

@@ -1,11 +0,0 @@
-# CHANGELOG
-
-<!-- version list -->
-
-## v1.0.0 (2026-04-13)
-
-- Initial Release
-
-## v1.0.0 (2026-04-10)
-
-- Initial Release

orchid_cli-1.0.0/PKG-INFO

@@ -1,20 +0,0 @@
-Metadata-Version: 2.4
-Name: orchid-cli
-Version: 1.0.0
-Summary: Orchid CLI — command-line interface for the Orchid agent framework
-License-File: LICENSE
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: langchain-core>=0.3.0
-Requires-Dist: orchid-ai>=1.2.0
-Requires-Dist: pydantic-settings>=2.7.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: rich>=13.0
-Requires-Dist: typer>=0.12.0
-Provides-Extra: dev
-Requires-Dist: gitlint>=0.19.0; extra == 'dev'
-Requires-Dist: pre-commit>=4.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
-Requires-Dist: pytest-cov>=6.0; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff>=0.9.0; extra == 'dev'