forgexa-cli 1.0.3__tar.gz → 1.0.4__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 (14) hide show
  1. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/PKG-INFO +55 -8
  2. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/README.md +51 -6
  3. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli/__init__.py +1 -1
  4. forgexa_cli-1.0.4/forgexa_cli/daemon.py +2964 -0
  5. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli/main.py +39 -1
  6. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli.egg-info/PKG-INFO +55 -8
  7. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli.egg-info/SOURCES.txt +2 -0
  8. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli.egg-info/entry_points.txt +1 -0
  9. forgexa_cli-1.0.4/forgexa_cli.egg-info/requires.txt +3 -0
  10. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/pyproject.toml +7 -3
  11. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli/py.typed +0 -0
  12. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli.egg-info/dependency_links.txt +0 -0
  13. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli.egg-info/top_level.txt +0 -0
  14. {forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/setup.cfg +0 -0
{forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/PKG-INFO RENAMED
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: forgexa-cli
3
- Version: 1.0.3
4
- Summary: Forgexa CLI — command-line client for managing workspaces, projects, requirements, and agent runtimes
3
+ Version: 1.0.4
4
+ Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
5
5
  Author-email: Shinetech <dev@shinetechsoftware.com>
6
6
  License: MIT
7
7
  Project-URL: Homepage, https://forgexa.net
@@ -24,12 +24,15 @@ Classifier: Topic :: Software Development :: Build Tools
24
24
  Classifier: Topic :: Software Development :: Quality Assurance
25
25
  Requires-Python: >=3.9
26
26
  Description-Content-Type: text/markdown
27
+ Provides-Extra: daemon
28
+ Requires-Dist: httpx>=0.24; extra == "daemon"
27
29
 
28
30
  # Forgexa CLI
29
31
 
30
- Command-line client for the [[Forgexa](https://forgexa.net) platform.
32
+ Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
31
33
 
32
- Lightweight, zero-dependency — communicates with the Forgexa server via REST API using only Python stdlib.
34
+ Lightweight — communicates with the Forgexa server via REST API using only Python stdlib.
35
+ Includes a built-in **daemon** that discovers local AI agents (Claude Code, Codex, Gemini CLI, OpenCode, Kimi Code, etc.) and executes tasks on behalf of the server.
33
36
 
34
37
  ## Installation
35
38
 
@@ -94,6 +97,8 @@ forgexa board --project <project-id>
94
97
  | `forgexa workflow show --project <id>` | Show workflow policy |
95
98
  | `forgexa workflow reload --project <id>` | Reload workflow |
96
99
  | `forgexa budget --workspace <id>` | Budget overview |
100
+ | `forgexa daemon start` | Start local daemon (discover agents, run tasks) |
101
+ | `forgexa daemon start -d` | Start daemon in background |
97
102
  | `forgexa daemon status` | Show daemon statuses |
98
103
  | `forgexa daemon stop` | Stop local daemon |
99
104
  | `forgexa runtimes list` | List runtimes |
@@ -116,14 +121,56 @@ forgexa workspace list --format quiet # IDs only
116
121
 
117
122
  ## Daemon Management
118
123
 
119
- The `forgexa` CLI handles remote daemon queries. To **start** a daemon locally,
120
- use the `forgexa-daemon` command from the backend package:
124
+ The daemon discovers locally installed AI agents and registers them with the Forgexa server.
125
+ It then polls for tasks and executes them using your local agents.
126
+
127
+ ### Start Daemon
128
+
129
+ ```bash
130
+ # Foreground (default — see logs, Ctrl+C to stop)
131
+ forgexa daemon start
132
+
133
+ # Background (detached)
134
+ forgexa daemon start -d
135
+
136
+ # Connect to a specific server
137
+ forgexa daemon start --server-url https://your-server.example.com
138
+
139
+ # Or via the standalone entry point
140
+ forgexa-daemon
141
+ ```
142
+
143
+ ### Other Daemon Commands
121
144
 
122
145
  ```bash
123
- pip install ./backend
124
- forgexa-daemon # starts the runtime daemon
146
+ # Check daemon status (from server)
147
+ forgexa daemon status
148
+
149
+ # Stop background daemon
150
+ forgexa daemon stop
125
151
  ```
126
152
 
153
+ ### Supported AI Agents
154
+
155
+ The daemon automatically discovers these agents if installed on your system:
156
+
157
+ | Agent | Command |
158
+ |-------|---------|
159
+ | Claude Code | `claude` |
160
+ | OpenAI Codex | `codex` |
161
+ | Gemini CLI | `gemini` |
162
+ | OpenCode | `opencode` |
163
+ | Kimi Code | `kimi` |
164
+
165
+ ### Environment Variables (Daemon)
166
+
167
+ | Variable | Default | Description |
168
+ |----------|---------|-------------|
169
+ | `DAEMON_SERVER_URL` | `http://localhost:8000` | Server to connect to |
170
+ | `DAEMON_API_TOKEN` | — | Auth token (auto-read from `~/.forgexa/token`) |
171
+ | `DAEMON_MAX_CONCURRENT` | `5` | Max parallel tasks |
172
+ | `DAEMON_POLL_INTERVAL` | `3` | Poll interval (seconds) |
173
+
127
174
  ## Publishing to PyPI
128
175
 
129
176
  ### Prerequisites
{forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/README.md RENAMED
@@ -1,8 +1,9 @@
1
1
  # Forgexa CLI
2
2
 
3
- Command-line client for the [[Forgexa](https://forgexa.net) platform.
3
+ Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
4
4
 
5
- Lightweight, zero-dependency — communicates with the Forgexa server via REST API using only Python stdlib.
5
+ Lightweight — communicates with the Forgexa server via REST API using only Python stdlib.
6
+ Includes a built-in **daemon** that discovers local AI agents (Claude Code, Codex, Gemini CLI, OpenCode, Kimi Code, etc.) and executes tasks on behalf of the server.
6
7
 
7
8
  ## Installation
8
9
 
@@ -67,6 +68,8 @@ forgexa board --project <project-id>
67
68
  | `forgexa workflow show --project <id>` | Show workflow policy |
68
69
  | `forgexa workflow reload --project <id>` | Reload workflow |
69
70
  | `forgexa budget --workspace <id>` | Budget overview |
71
+ | `forgexa daemon start` | Start local daemon (discover agents, run tasks) |
72
+ | `forgexa daemon start -d` | Start daemon in background |
70
73
  | `forgexa daemon status` | Show daemon statuses |
71
74
  | `forgexa daemon stop` | Stop local daemon |
72
75
  | `forgexa runtimes list` | List runtimes |
@@ -89,14 +92,56 @@ forgexa workspace list --format quiet # IDs only
89
92
 
90
93
  ## Daemon Management
91
94
 
92
- The `forgexa` CLI handles remote daemon queries. To **start** a daemon locally,
93
- use the `forgexa-daemon` command from the backend package:
95
+ The daemon discovers locally installed AI agents and registers them with the Forgexa server.
96
+ It then polls for tasks and executes them using your local agents.
97
+
98
+ ### Start Daemon
99
+
100
+ ```bash
101
+ # Foreground (default — see logs, Ctrl+C to stop)
102
+ forgexa daemon start
103
+
104
+ # Background (detached)
105
+ forgexa daemon start -d
106
+
107
+ # Connect to a specific server
108
+ forgexa daemon start --server-url https://your-server.example.com
109
+
110
+ # Or via the standalone entry point
111
+ forgexa-daemon
112
+ ```
113
+
114
+ ### Other Daemon Commands
94
115
 
95
116
  ```bash
96
- pip install ./backend
97
- forgexa-daemon # starts the runtime daemon
117
+ # Check daemon status (from server)
118
+ forgexa daemon status
119
+
120
+ # Stop background daemon
121
+ forgexa daemon stop
98
122
  ```
99
123
 
124
+ ### Supported AI Agents
125
+
126
+ The daemon automatically discovers these agents if installed on your system:
127
+
128
+ | Agent | Command |
129
+ |-------|---------|
130
+ | Claude Code | `claude` |
131
+ | OpenAI Codex | `codex` |
132
+ | Gemini CLI | `gemini` |
133
+ | OpenCode | `opencode` |
134
+ | Kimi Code | `kimi` |
135
+
136
+ ### Environment Variables (Daemon)
137
+
138
+ | Variable | Default | Description |
139
+ |----------|---------|-------------|
140
+ | `DAEMON_SERVER_URL` | `http://localhost:8000` | Server to connect to |
141
+ | `DAEMON_API_TOKEN` | — | Auth token (auto-read from `~/.forgexa/token`) |
142
+ | `DAEMON_MAX_CONCURRENT` | `5` | Max parallel tasks |
143
+ | `DAEMON_POLL_INTERVAL` | `3` | Poll interval (seconds) |
144
+
100
145
  ## Publishing to PyPI
101
146
 
102
147
  ### Prerequisites
{forgexa_cli-1.0.3 → forgexa_cli-1.0.4}/forgexa_cli/__init__.py RENAMED
@@ -1,2 +1,2 @@
1
1
  """forgexa-cli — Forgexa command-line client."""
2
- __version__ = "1.0.3"
2
+ __version__ = "1.0.4"