orchex-cli 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. orchex_cli-0.1.0/.gitignore +5 -0
  2. orchex_cli-0.1.0/PKG-INFO +110 -0
  3. orchex_cli-0.1.0/README.md +79 -0
  4. orchex_cli-0.1.0/docs/plans/2026-04-08-orchex-phase2.md +792 -0
  5. orchex_cli-0.1.0/docs/plans/2026-04-08-orchex-phase3.md +506 -0
  6. orchex_cli-0.1.0/docs/plans/2026-04-08-orchex-phase4.md +512 -0
  7. orchex_cli-0.1.0/docs/plans/2026-04-08-orchex-phase5.md +434 -0
  8. orchex_cli-0.1.0/docs/superpowers/plans/2026-04-08-npm-distribution.md +568 -0
  9. orchex_cli-0.1.0/docs/superpowers/specs/2026-04-08-npm-distribution-design.md +160 -0
  10. orchex_cli-0.1.0/npm/bin/orchex +21 -0
  11. orchex_cli-0.1.0/npm/package.json +38 -0
  12. orchex_cli-0.1.0/npm/scripts/postinstall.js +60 -0
  13. orchex_cli-0.1.0/pyproject.toml +53 -0
  14. orchex_cli-0.1.0/src/orchex/__init__.py +1 -0
  15. orchex_cli-0.1.0/src/orchex/__main__.py +2 -0
  16. orchex_cli-0.1.0/src/orchex/adapters/__init__.py +0 -0
  17. orchex_cli-0.1.0/src/orchex/adapters/base.py +40 -0
  18. orchex_cli-0.1.0/src/orchex/adapters/claude.py +62 -0
  19. orchex_cli-0.1.0/src/orchex/adapters/codex.py +46 -0
  20. orchex_cli-0.1.0/src/orchex/adapters/gemini.py +46 -0
  21. orchex_cli-0.1.0/src/orchex/adapters/registry.py +11 -0
  22. orchex_cli-0.1.0/src/orchex/cli.py +286 -0
  23. orchex_cli-0.1.0/src/orchex/config/__init__.py +0 -0
  24. orchex_cli-0.1.0/src/orchex/config/loader.py +58 -0
  25. orchex_cli-0.1.0/src/orchex/config/schema.py +23 -0
  26. orchex_cli-0.1.0/src/orchex/core/__init__.py +0 -0
  27. orchex_cli-0.1.0/src/orchex/core/consensus.py +138 -0
  28. orchex_cli-0.1.0/src/orchex/core/engine.py +206 -0
  29. orchex_cli-0.1.0/src/orchex/core/features.py +33 -0
  30. orchex_cli-0.1.0/src/orchex/core/instructions.py +38 -0
  31. orchex_cli-0.1.0/src/orchex/core/pty_runner.py +74 -0
  32. orchex_cli-0.1.0/src/orchex/core/router.py +55 -0
  33. orchex_cli-0.1.0/src/orchex/core/task.py +64 -0
  34. orchex_cli-0.1.0/src/orchex/core/worktree.py +86 -0
  35. orchex_cli-0.1.0/src/orchex/daemon/__init__.py +0 -0
  36. orchex_cli-0.1.0/src/orchex/daemon/ipc.py +66 -0
  37. orchex_cli-0.1.0/src/orchex/daemon/protocol.py +37 -0
  38. orchex_cli-0.1.0/src/orchex/daemon/server.py +241 -0
  39. orchex_cli-0.1.0/src/orchex/notify/__init__.py +0 -0
  40. orchex_cli-0.1.0/src/orchex/notify/base.py +39 -0
  41. orchex_cli-0.1.0/src/orchex/notify/discord.py +25 -0
  42. orchex_cli-0.1.0/src/orchex/notify/telegram.py +27 -0
  43. orchex_cli-0.1.0/tests/__init__.py +0 -0
  44. orchex_cli-0.1.0/tests/test_claude_adapter.py +24 -0
  45. orchex_cli-0.1.0/tests/test_cli.py +22 -0
  46. orchex_cli-0.1.0/tests/test_codex_adapter.py +26 -0
  47. orchex_cli-0.1.0/tests/test_config.py +29 -0
  48. orchex_cli-0.1.0/tests/test_consensus.py +58 -0
  49. orchex_cli-0.1.0/tests/test_features.py +48 -0
  50. orchex_cli-0.1.0/tests/test_gemini_adapter.py +26 -0
  51. orchex_cli-0.1.0/tests/test_instructions.py +53 -0
  52. orchex_cli-0.1.0/tests/test_integration.py +64 -0
  53. orchex_cli-0.1.0/tests/test_ipc.py +42 -0
  54. orchex_cli-0.1.0/tests/test_notify.py +40 -0
  55. orchex_cli-0.1.0/tests/test_parallel.py +114 -0
  56. orchex_cli-0.1.0/tests/test_pty_runner.py +23 -0
  57. orchex_cli-0.1.0/tests/test_router.py +54 -0
  58. orchex_cli-0.1.0/tests/test_task.py +40 -0
  59. orchex_cli-0.1.0/tests/test_worktree.py +55 -0
orchex_cli-0.1.0/.gitignore ADDED
@@ -0,0 +1,5 @@
1
+ .omc/
2
+ .orchex-worktrees/
3
+ node_modules/
4
+ dist/
5
+ *.egg-info/
orchex_cli-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,110 @@
1
+ Metadata-Version: 2.4
2
+ Name: orchex-cli
3
+ Version: 0.1.0
4
+ Summary: Multi-provider AI coding agent orchestrator
5
+ Project-URL: Homepage, https://github.com/orchex-cli/orchex
6
+ Project-URL: Repository, https://github.com/orchex-cli/orchex
7
+ Project-URL: Issues, https://github.com/orchex-cli/orchex/issues
8
+ Author-email: tech-mentat <tech@mentat.so>
9
+ License-Expression: MIT
10
+ Keywords: ai,claude,codex,coding,gemini,orchestrator
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.9
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Libraries
22
+ Requires-Python: >=3.9
23
+ Requires-Dist: click>=8.0
24
+ Requires-Dist: rich>=13.0
25
+ Requires-Dist: tomli-w>=1.0
26
+ Requires-Dist: tomli>=2.0; python_version < '3.11'
27
+ Provides-Extra: dev
28
+ Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
29
+ Requires-Dist: pytest>=8.0; extra == 'dev'
30
+ Description-Content-Type: text/markdown
31
+
32
+ # orchex
33
+
34
+ Multi-provider AI coding agent orchestrator. An intelligent coding tool that runs in the terminal — Claude Code, Codex CLI, and Gemini CLI collaborate on every request, cross-review each other's work, and deliver a unified team answer.
35
+
36
+ ## Installation
37
+
38
+ ```bash
39
+ # via npm (recommended)
40
+ npm install -g orchex
41
+
42
+ # or via pipx
43
+ pipx install orchex-cli
44
+
45
+ # or via pip
46
+ pip install orchex-cli
47
+ ```
48
+
49
+ ## Requirements
50
+
51
+ - Python 3.9+
52
+ - Node.js 16+ (for npm installation only)
53
+ - At least one of: Claude Code, Codex CLI, Gemini CLI
54
+
55
+ ## Quick Start
56
+
57
+ ```bash
58
+ # Launch interactive mode
59
+ orchex
60
+
61
+ # Ask a question directly
62
+ orchex ask "Explain the authentication flow in this codebase"
63
+
64
+ # Check agent status
65
+ orchex agents
66
+ ```
67
+
68
+ ## How It Works
69
+
70
+ 1. **You ask a question** — type anything in the interactive prompt
71
+ 2. **All agents research independently** — Claude, Codex, and Gemini work in parallel
72
+ 3. **Cross-review** — each agent reviews the others' responses
73
+ 4. **Unified answer** — a consolidated team document is delivered
74
+
75
+ ## Interactive Commands
76
+
77
+ | Command | Action |
78
+ |---------|--------|
79
+ | `/agents` | Show agent status |
80
+ | `/verbose` | Toggle detailed output (show individual responses + reviews) |
81
+ | `/help` | Show help |
82
+ | `/quit` | Exit |
83
+
84
+ ## Configuration
85
+
86
+ Create `.orchex/config.toml` in your project:
87
+
88
+ ```toml
89
+ [ideation]
90
+ max_rounds = 5
91
+ discussion_mode = "free"
92
+
93
+ [routing.defaults]
94
+ architecture = "claude"
95
+ implementation = "codex"
96
+ research = "gemini"
97
+
98
+ [notify.telegram]
99
+ enabled = false
100
+ bot_token = "env:ORCHEX_TG_TOKEN"
101
+ chat_id = "env:ORCHEX_TG_CHAT_ID"
102
+
103
+ [notify.discord]
104
+ enabled = false
105
+ webhook_url = "env:ORCHEX_DISCORD_WEBHOOK"
106
+ ```
107
+
108
+ ## License
109
+
110
+ MIT
orchex_cli-0.1.0/README.md ADDED
@@ -0,0 +1,79 @@
1
+ # orchex
2
+
3
+ Multi-provider AI coding agent orchestrator. An intelligent coding tool that runs in the terminal — Claude Code, Codex CLI, and Gemini CLI collaborate on every request, cross-review each other's work, and deliver a unified team answer.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ # via npm (recommended)
9
+ npm install -g orchex
10
+
11
+ # or via pipx
12
+ pipx install orchex-cli
13
+
14
+ # or via pip
15
+ pip install orchex-cli
16
+ ```
17
+
18
+ ## Requirements
19
+
20
+ - Python 3.9+
21
+ - Node.js 16+ (for npm installation only)
22
+ - At least one of: Claude Code, Codex CLI, Gemini CLI
23
+
24
+ ## Quick Start
25
+
26
+ ```bash
27
+ # Launch interactive mode
28
+ orchex
29
+
30
+ # Ask a question directly
31
+ orchex ask "Explain the authentication flow in this codebase"
32
+
33
+ # Check agent status
34
+ orchex agents
35
+ ```
36
+
37
+ ## How It Works
38
+
39
+ 1. **You ask a question** — type anything in the interactive prompt
40
+ 2. **All agents research independently** — Claude, Codex, and Gemini work in parallel
41
+ 3. **Cross-review** — each agent reviews the others' responses
42
+ 4. **Unified answer** — a consolidated team document is delivered
43
+
44
+ ## Interactive Commands
45
+
46
+ | Command | Action |
47
+ |---------|--------|
48
+ | `/agents` | Show agent status |
49
+ | `/verbose` | Toggle detailed output (show individual responses + reviews) |
50
+ | `/help` | Show help |
51
+ | `/quit` | Exit |
52
+
53
+ ## Configuration
54
+
55
+ Create `.orchex/config.toml` in your project:
56
+
57
+ ```toml
58
+ [ideation]
59
+ max_rounds = 5
60
+ discussion_mode = "free"
61
+
62
+ [routing.defaults]
63
+ architecture = "claude"
64
+ implementation = "codex"
65
+ research = "gemini"
66
+
67
+ [notify.telegram]
68
+ enabled = false
69
+ bot_token = "env:ORCHEX_TG_TOKEN"
70
+ chat_id = "env:ORCHEX_TG_CHAT_ID"
71
+
72
+ [notify.discord]
73
+ enabled = false
74
+ webhook_url = "env:ORCHEX_DISCORD_WEBHOOK"
75
+ ```
76
+
77
+ ## License
78
+
79
+ MIT