opensandbox-cli 0.1.0.dev1__py3-none-any.whl

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.
@@ -0,0 +1,612 @@
1
+ Metadata-Version: 2.4
2
+ Name: opensandbox-cli
3
+ Version: 0.1.0.dev1
4
+ Summary: OpenSandbox CLI - Command-line interface for managing sandboxes
5
+ Project-URL: Homepage, https://open-sandbox.ai
6
+ Project-URL: Repository, https://github.com/alibaba/OpenSandbox
7
+ Project-URL: Documentation, https://open-sandbox.ai
8
+ Project-URL: Issues, https://github.com/alibaba/OpenSandbox/issues
9
+ Author-email: OpenSandbox Team <ninan.nn@alibaba-inc.com>
10
+ License: Apache License
11
+ Version 2.0, January 2004
12
+ http://www.apache.org/licenses/
13
+
14
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
15
+
16
+ 1. Definitions.
17
+
18
+ "License" shall mean the terms and conditions for use, reproduction,
19
+ and distribution as defined by Sections 1 through 9 of this document.
20
+
21
+ "Licensor" shall mean the copyright owner or entity authorized by
22
+ the copyright owner that is granting the License.
23
+
24
+ "Legal Entity" shall mean the union of the acting entity and all
25
+ other entities that control, are controlled by, or are under common
26
+ control with that entity. For the purposes of this definition,
27
+ "control" means (i) the power, direct or indirect, to cause the
28
+ direction or management of such entity, whether by contract or
29
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
30
+ outstanding shares, or (iii) beneficial ownership of such entity.
31
+
32
+ "You" (or "Your") shall mean an individual or Legal Entity
33
+ exercising permissions granted by this License.
34
+
35
+ "Source" form shall mean the preferred form for making modifications,
36
+ including but not limited to software source code, documentation
37
+ source, and configuration files.
38
+
39
+ "Object" form shall mean any form resulting from mechanical
40
+ transformation or translation of a Source form, including but
41
+ not limited to compiled object code, generated documentation,
42
+ and conversions to other media types.
43
+
44
+ "Work" shall mean the work of authorship, whether in Source or
45
+ Object form, made available under the License, as indicated by a
46
+ copyright notice that is included in or attached to the work
47
+ (an example is provided in the Appendix below).
48
+
49
+ "Derivative Works" shall mean any work, whether in Source or Object
50
+ form, that is based on (or derived from) the Work and for which the
51
+ editorial revisions, annotations, elaborations, or other modifications
52
+ represent, as a whole, an original work of authorship. For the purposes
53
+ of this License, Derivative Works shall not include works that remain
54
+ separable from, or merely link (or bind by name) to the interfaces of,
55
+ the Work and Derivative Works thereof.
56
+
57
+ "Contribution" shall mean any work of authorship, including
58
+ the original version of the Work and any modifications or additions
59
+ to that Work or Derivative Works thereof, that is intentionally
60
+ submitted to Licensor for inclusion in the Work by the copyright owner
61
+ or by an individual or Legal Entity authorized to submit on behalf of
62
+ the copyright owner. For the purposes of this definition, "submitted"
63
+ means any form of electronic, verbal, or written communication sent
64
+ to the Licensor or its representatives, including but not limited to
65
+ communication on electronic mailing lists, source code control systems,
66
+ and issue tracking systems that are managed by, or on behalf of, the
67
+ Licensor for the purpose of discussing and improving the Work, but
68
+ excluding communication that is conspicuously marked or otherwise
69
+ designated in writing by the copyright owner as "Not a Contribution."
70
+
71
+ "Contributor" shall mean Licensor and any individual or Legal Entity
72
+ on behalf of whom a Contribution has been received by Licensor and
73
+ subsequently incorporated within the Work.
74
+
75
+ 2. Grant of Copyright License. Subject to the terms and conditions of
76
+ this License, each Contributor hereby grants to You a perpetual,
77
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
78
+ copyright license to reproduce, prepare Derivative Works of,
79
+ publicly display, publicly perform, sublicense, and distribute the
80
+ Work and such Derivative Works in Source or Object form.
81
+
82
+ 3. Grant of Patent License. Subject to the terms and conditions of
83
+ this License, each Contributor hereby grants to You a perpetual,
84
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
85
+ (except as stated in this section) patent license to make, have made,
86
+ use, offer to sell, sell, import, and otherwise transfer the Work,
87
+ where such license applies only to those patent claims licensable
88
+ by such Contributor that are necessarily infringed by their
89
+ Contribution(s) alone or by combination of their Contribution(s)
90
+ with the Work to which such Contribution(s) was submitted. If You
91
+ institute patent litigation against any entity (including a
92
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
93
+ or a Contribution incorporated within the Work constitutes direct
94
+ or contributory patent infringement, then any patent licenses
95
+ granted to You under this License for that Work shall terminate
96
+ as of the date such litigation is filed.
97
+
98
+ 4. Redistribution. You may reproduce and distribute copies of the
99
+ Work or Derivative Works thereof in any medium, with or without
100
+ modifications, and in Source or Object form, provided that You
101
+ meet the following conditions:
102
+
103
+ (a) You must give any other recipients of the Work or
104
+ Derivative Works a copy of this License; and
105
+
106
+ (b) You must cause any modified files to carry prominent notices
107
+ stating that You changed the files; and
108
+
109
+ (c) You must retain, in the Source form of any Derivative Works
110
+ that You distribute, all copyright, patent, trademark, and
111
+ attribution notices from the Source form of the Work,
112
+ excluding those notices that do not pertain to any part of
113
+ the Derivative Works; and
114
+
115
+ (d) If the Work includes a "NOTICE" text file as part of its
116
+ distribution, then any Derivative Works that You distribute must
117
+ include a readable copy of the attribution notices contained
118
+ within such NOTICE file, excluding those notices that do not
119
+ pertain to any part of the Derivative Works, in at least one
120
+ of the following places: within a NOTICE text file distributed
121
+ as part of the Derivative Works; within the Source form or
122
+ documentation, if provided along with the Derivative Works; or,
123
+ within a display generated by the Derivative Works, if and
124
+ wherever such third-party notices normally appear. The contents
125
+ of the NOTICE file are for informational purposes only and
126
+ do not modify the License. You may add Your own attribution
127
+ notices within Derivative Works that You distribute, alongside
128
+ or as an addendum to the NOTICE text from the Work, provided
129
+ that such additional attribution notices cannot be construed
130
+ as modifying the License.
131
+
132
+ You may add Your own copyright statement to Your modifications and
133
+ may provide additional or different license terms and conditions
134
+ for use, reproduction, or distribution of Your modifications, or
135
+ for any such Derivative Works as a whole, provided Your use,
136
+ reproduction, and distribution of the Work otherwise complies with
137
+ the conditions stated in this License.
138
+
139
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
140
+ any Contribution intentionally submitted for inclusion in the Work
141
+ by You to the Licensor shall be under the terms and conditions of
142
+ this License, without any additional terms or conditions.
143
+ Notwithstanding the above, nothing herein shall supersede or modify
144
+ the terms of any separate license agreement you may have executed
145
+ with Licensor regarding such Contributions.
146
+
147
+ 6. Trademarks. This License does not grant permission to use the trade
148
+ names, trademarks, service marks, or product names of the Licensor,
149
+ except as required for reasonable and customary use in describing the
150
+ origin of the Work and reproducing the content of the NOTICE file.
151
+
152
+ 7. Disclaimer of Warranty. Unless required by applicable law or
153
+ agreed to in writing, Licensor provides the Work (and each
154
+ Contributor provides its Contributions) on an "AS IS" BASIS,
155
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
156
+ implied, including, without limitation, any warranties or conditions
157
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
158
+ PARTICULAR PURPOSE. You are solely responsible for determining the
159
+ appropriateness of using or redistributing the Work and assume any
160
+ risks associated with Your exercise of permissions under this License.
161
+
162
+ 8. Limitation of Liability. In no event and under no legal theory,
163
+ whether in tort (including negligence), contract, or otherwise,
164
+ unless required by applicable law (such as deliberate and grossly
165
+ negligent acts) or agreed to in writing, shall any Contributor be
166
+ liable to You for damages, including any direct, indirect, special,
167
+ incidental, or consequential damages of any character arising as a
168
+ result of this License or out of the use or inability to use the
169
+ Work (including but not limited to damages for loss of goodwill,
170
+ work stoppage, computer failure or malfunction, or any and all
171
+ other commercial damages or losses), even if such Contributor
172
+ has been advised of the possibility of such damages.
173
+
174
+ 9. Accepting Warranty or Additional Liability. While redistributing
175
+ the Work or Derivative Works thereof, You may choose to offer,
176
+ and charge a fee for, acceptance of support, warranty, indemnity,
177
+ or other liability obligations and/or rights consistent with this
178
+ License. However, in accepting such obligations, You may act only
179
+ on Your own behalf and on Your sole responsibility, not on behalf
180
+ of any other Contributor, and only if You agree to indemnify,
181
+ defend, and hold each Contributor harmless for any liability
182
+ incurred by, or claims asserted against, such Contributor by reason
183
+ of your accepting any such warranty or additional liability.
184
+
185
+ END OF TERMS AND CONDITIONS
186
+
187
+ APPENDIX: How to apply the Apache License to your work.
188
+
189
+ To apply the Apache License to your work, attach the following
190
+ boilerplate notice, with the fields enclosed by brackets "[]"
191
+ replaced with your own identifying information. (Don't include
192
+ the brackets!) The text should be enclosed in the appropriate
193
+ comment syntax for the file format. We also recommend that a
194
+ file or class name and description of purpose be included on the
195
+ same "printed page" as the copyright notice for easier
196
+ identification within third-party archives.
197
+
198
+ Copyright [yyyy] [name of copyright owner]
199
+
200
+ Licensed under the Apache License, Version 2.0 (the "License");
201
+ you may not use this file except in compliance with the License.
202
+ You may obtain a copy of the License at
203
+
204
+ http://www.apache.org/licenses/LICENSE-2.0
205
+
206
+ Unless required by applicable law or agreed to in writing, software
207
+ distributed under the License is distributed on an "AS IS" BASIS,
208
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
209
+ See the License for the specific language governing permissions and
210
+ limitations under the License.
211
+ License-File: LICENSE
212
+ Keywords: cli,opensandbox,sandbox
213
+ Classifier: Development Status :: 3 - Alpha
214
+ Classifier: Intended Audience :: Developers
215
+ Classifier: License :: OSI Approved :: Apache Software License
216
+ Classifier: Operating System :: OS Independent
217
+ Classifier: Programming Language :: Python :: 3
218
+ Classifier: Programming Language :: Python :: 3 :: Only
219
+ Classifier: Programming Language :: Python :: 3.10
220
+ Classifier: Programming Language :: Python :: 3.11
221
+ Classifier: Programming Language :: Python :: 3.12
222
+ Classifier: Programming Language :: Python :: 3.13
223
+ Classifier: Topic :: Software Development :: Libraries
224
+ Classifier: Typing :: Typed
225
+ Requires-Python: >=3.10
226
+ Requires-Dist: click<9.0,>=8.1.0
227
+ Requires-Dist: opensandbox<0.2.0,>=0.1.5
228
+ Requires-Dist: pyyaml<7.0,>=6.0
229
+ Requires-Dist: rich<14.0,>=13.0.0
230
+ Requires-Dist: tomli>=2.0.0; python_version < '3.11'
231
+ Description-Content-Type: text/markdown
232
+
233
+ # OpenSandbox CLI
234
+
235
+ A command-line interface for managing OpenSandbox environments from your terminal. Built on top of the [OpenSandbox Python SDK](../sdks/sandbox/python/README.md), the CLI provides intuitive commands for sandbox lifecycle management, file operations, command execution, and diagnostics.
236
+
237
+ ## Installation
238
+
239
+ ### pip
240
+
241
+ ```bash
242
+ pip install opensandbox-cli
243
+ ```
244
+
245
+ ### uv
246
+
247
+ ```bash
248
+ uv tool install opensandbox-cli
249
+ ```
250
+
251
+ ### pipx (recommended for global CLI usage)
252
+
253
+ ```bash
254
+ pipx install opensandbox-cli
255
+ ```
256
+
257
+ ## Overview
258
+
259
+ ```bash
260
+ osb --help
261
+ ```
262
+
263
+ ![CLI Help](assets/cli_help.png)
264
+
265
+ ## Quick Start
266
+
267
+ ### Step 0: Start the OpenSandbox Server
268
+
269
+ Before using the CLI, make sure the OpenSandbox server is running. See the root [README.md](../README.md) for startup instructions.
270
+
271
+ ```bash
272
+ opensandbox-server
273
+ ```
274
+
275
+ ![Start OpenSandbox Server](assets/start_opensandbox_server.png)
276
+
277
+ ### Step 1: Install the CLI
278
+
279
+ ```bash
280
+ cd cli
281
+ uv sync
282
+ uv run osb --help
283
+ ```
284
+
285
+ ![Install CLI](assets/install_cli.png)
286
+
287
+ ### Step 2: Initialize Configuration
288
+
289
+ ```bash
290
+ osb config init
291
+ osb config set connection.domain localhost:8080
292
+ osb config set connection.protocol http
293
+ ```
294
+
295
+ ![Init CLI](assets/init_cli.png)
296
+
297
+ ### Step 3: Create a Sandbox
298
+
299
+ ```bash
300
+ osb sandbox create --image python:3.12
301
+ ```
302
+
303
+ Or configure defaults once and omit repeated flags:
304
+
305
+ ```bash
306
+ osb config set defaults.image python:3.12
307
+ osb config set defaults.timeout 15m
308
+ osb sandbox create
309
+ ```
310
+
311
+ You can also load network policy and volume mounts from JSON files:
312
+
313
+ ```bash
314
+ osb sandbox create \
315
+ --image python:3.12 \
316
+ --network-policy-file network-policy.json \
317
+ --volumes-file volumes.json
318
+ ```
319
+
320
+ ![Create Sandbox](assets/cli_create_sandbox.png)
321
+
322
+ ### Step 4: List Sandboxes
323
+
324
+ ```bash
325
+ # Table output (default)
326
+ osb sandbox list
327
+
328
+ # JSON output for scripting
329
+ osb -o json sandbox list
330
+ ```
331
+
332
+ ![List Sandboxes](assets/cli_list_sandbox.png)
333
+
334
+ ![List Sandboxes JSON](assets/cli_list_sandbox_json.png)
335
+
336
+ ### Short ID Matching
337
+
338
+ Like Docker, you don't need to type the full sandbox ID — just enough characters to uniquely identify the target sandbox:
339
+
340
+ ```bash
341
+ # Full ID
342
+ osb sandbox get db027570-4f86-45f8-b1a8-c31a2dd90da8
343
+
344
+ # Short prefix — as long as it's unambiguous
345
+ osb sandbox get db02
346
+ osb exec db02 -- echo "hello"
347
+ ```
348
+
349
+ If the prefix matches multiple sandboxes, the CLI will report an error listing the matches so you can be more specific.
350
+
351
+ ![Short ID Matching](assets/cli_sandbox_search.png)
352
+
353
+ ### Step 5: Execute Commands
354
+
355
+ ```bash
356
+ osb exec <sandbox-id> -- echo "hello world"
357
+ osb exec <sandbox-id> -- python -c "print(1+1)"
358
+ ```
359
+
360
+ ![Execute Commands](assets/cli_sandbox_exec.png)
361
+
362
+ ### Step 6: File Operations
363
+
364
+ ```bash
365
+ # Write a file
366
+ osb file write <sandbox-id> /tmp/test.txt -c "hello"
367
+
368
+ # Read it back
369
+ osb file cat <sandbox-id> /tmp/test.txt
370
+ ```
371
+
372
+ ![File Operations](assets/cli_sandbox_file.png)
373
+
374
+ ### Step 7: Cleanup
375
+
376
+ ```bash
377
+ osb sandbox kill <sandbox-id>
378
+ osb sandbox list
379
+ ```
380
+
381
+ ![Kill Sandbox](assets/cli_kill_sandbox.png)
382
+
383
+ ## Command Reference
384
+
385
+ ### `osb sandbox` — Lifecycle Management
386
+
387
+ | Command | Description |
388
+ | ---------- | ------------------------------------------- |
389
+ | `create` | Create a new sandbox |
390
+ | `list` | List sandboxes (with optional filters) |
391
+ | `get` | Get sandbox details by ID |
392
+ | `kill` | Terminate one or more sandboxes |
393
+ | `pause` | Pause a running sandbox |
394
+ | `resume` | Resume a paused sandbox |
395
+ | `renew` | Renew sandbox expiration |
396
+ | `endpoint` | Get public endpoint for a sandbox port |
397
+ | `health` | Check sandbox health |
398
+ | `metrics` | Get sandbox resource metrics (CPU, memory) |
399
+
400
+ ### `osb command` — Command Execution
401
+
402
+ | Command | Description |
403
+ | ----------- | ----------------------------------------- |
404
+ | `run` | Run a shell command in the sandbox |
405
+ | `status` | Get command execution status |
406
+ | `logs` | Get background command logs |
407
+ | `interrupt` | Interrupt a running command |
408
+ | `session` | Manage persistent bash sessions |
409
+
410
+ ### `osb exec` — Quick Command Shortcut
411
+
412
+ ```bash
413
+ osb exec <sandbox-id> -- <command>
414
+ ```
415
+
416
+ Shortcut for `osb command run`. Everything after `--` is passed as the command.
417
+
418
+ Persistent shell sessions:
419
+
420
+ ```bash
421
+ # Create a bash session
422
+ osb command session create <sandbox-id>
423
+
424
+ # Reuse that session for multiple commands
425
+ osb command session run <sandbox-id> <session-id> -- pwd
426
+ osb command session run <sandbox-id> <session-id> -- export FOO=bar
427
+ osb command session run <sandbox-id> <session-id> -- sh -c 'echo $FOO'
428
+
429
+ # Delete the session when done
430
+ osb command session delete <sandbox-id> <session-id>
431
+ ```
432
+
433
+ ### `osb file` — File Operations
434
+
435
+ | Command | Description |
436
+ | ---------- | ------------------------------------------ |
437
+ | `cat` | Read file contents |
438
+ | `write` | Write content to a file |
439
+ | `upload` | Upload a local file to the sandbox |
440
+ | `download` | Download a file from the sandbox |
441
+ | `rm` | Delete files |
442
+ | `mv` | Move or rename a file |
443
+ | `mkdir` | Create directories |
444
+ | `rmdir` | Remove directories |
445
+ | `search` | Search for files by pattern |
446
+ | `info` | Get file/directory metadata |
447
+ | `chmod` | Set file permissions |
448
+ | `replace` | Find and replace content in a file |
449
+
450
+ ### `osb egress` — Runtime Egress Policy
451
+
452
+ | Command | Description |
453
+ | ------- | ---------------------------------------- |
454
+ | `get` | Get the current runtime egress policy |
455
+ | `patch` | Patch runtime egress rules with merge semantics |
456
+
457
+ ```bash
458
+ # Inspect current policy
459
+ osb egress get <sandbox-id>
460
+
461
+ # Allow PyPI and deny an internal domain
462
+ osb egress patch <sandbox-id> --rule allow=pypi.org --rule deny=internal.example.com
463
+ ```
464
+
465
+ ### `osb devops` — Experimental DevOps Diagnostics
466
+
467
+ | Command | Description |
468
+ | --------- | ---------------------------------------------------- |
469
+ | `logs` | Retrieve container/pod logs |
470
+ | `inspect` | Retrieve detailed container/pod inspection info |
471
+ | `events` | Retrieve events related to a sandbox |
472
+ | `summary` | One-shot diagnostics: inspect + events + logs combined |
473
+
474
+ These diagnostics commands are currently experimental. They are implemented by the server and exposed by the CLI, but are not yet part of the public `specs/` API contract and may change before being formalized.
475
+
476
+ ```bash
477
+ # Quick diagnostics summary
478
+ osb devops summary <sandbox-id>
479
+
480
+ # Get last 500 log lines
481
+ osb devops logs <sandbox-id> --tail 500
482
+
483
+ # Get logs from the last 30 minutes
484
+ osb devops logs <sandbox-id> --since 30m
485
+
486
+ # Detailed container/pod inspection
487
+ osb devops inspect <sandbox-id>
488
+
489
+ # View events (up to 100)
490
+ osb devops events <sandbox-id> --limit 100
491
+ ```
492
+
493
+ All devops commands return plain text output, making them ideal for both human reading and AI agent consumption.
494
+
495
+ ![DevOps Summary 1](assets/cli_devops_summary_1.png)
496
+
497
+ ![DevOps Summary 2](assets/cli_devops_summary_2.png)
498
+
499
+ ### `osb skills` — AI Coding Skills
500
+
501
+ | Command | Description |
502
+ | ----------- | ---------------------------------------------------- |
503
+ | `install` | Install OpenSandbox troubleshooting skill for AI tools |
504
+ | `list` | List supported targets and their install status |
505
+ | `uninstall` | Remove installed skill from AI tools |
506
+
507
+ The troubleshooting skill enables AI coding assistants to automatically diagnose sandbox issues (OOM, crashes, image pull errors, etc.). Supported targets:
508
+
509
+ | Target | AI Tool | Install Location |
510
+ | --------- | ---------------- | ---------------- |
511
+ | `claude` | Claude Code | `~/.claude/skills/` |
512
+ | `cursor` | Cursor | `~/.cursor/rules/` |
513
+ | `codex` | Codex | `~/.codex/instructions.md` |
514
+ | `copilot` | GitHub Copilot | `~/.github/copilot-instructions.md` |
515
+ | `windsurf`| Windsurf | `~/.windsurfrules` |
516
+ | `cline` | Cline | `~/.clinerules` |
517
+
518
+ ```bash
519
+ # Install for Claude Code (default)
520
+ osb skills install
521
+
522
+ # Install for a specific tool
523
+ osb skills install --target cursor
524
+
525
+ # Install for all supported tools
526
+ osb skills install --target all
527
+
528
+ # Check install status
529
+ osb skills list
530
+
531
+ # Uninstall
532
+ osb skills uninstall --target claude
533
+ ```
534
+
535
+ ### `osb config` — Configuration
536
+
537
+ | Command | Description |
538
+ | ------- | ------------------------------------------ |
539
+ | `init` | Create a default config file |
540
+ | `show` | Show resolved configuration |
541
+
542
+ ## Configuration
543
+
544
+ The CLI resolves configuration from multiple sources with the following priority (highest to lowest):
545
+
546
+ 1. **CLI flags** — `--api-key`, `--domain`, `--protocol`, `--timeout`
547
+ 2. **Environment variables** — `OPEN_SANDBOX_API_KEY`, `OPEN_SANDBOX_DOMAIN`, `OPEN_SANDBOX_PROTOCOL`, `OPEN_SANDBOX_REQUEST_TIMEOUT`, `OPEN_SANDBOX_OUTPUT`
548
+ 3. **Config file** — `~/.opensandbox/config.toml` (or path specified via `--config`)
549
+ 4. **SDK defaults**
550
+
551
+ ## Development
552
+
553
+ For local CLI development in this monorepo, prefer `uv sync` from the `cli/` directory. That workflow honors the local `[tool.uv.sources]` override for `opensandbox`, so the CLI resolves against the checked-out SDK instead of the published package.
554
+
555
+ ```bash
556
+ cd cli
557
+ uv sync
558
+ uv run osb --help
559
+ ```
560
+
561
+ If you specifically need an editable install into another environment, install the SDK dependencies from their local paths first, then install the CLI.
562
+
563
+ ### Config File Format
564
+
565
+ ```toml
566
+ [connection]
567
+ api_key = "your-api-key"
568
+ domain = "localhost:8080"
569
+ protocol = "http"
570
+ request_timeout = 30
571
+
572
+ [output]
573
+ format = "table" # table | json | yaml
574
+ color = true
575
+
576
+ [defaults]
577
+ image = "python:3.11"
578
+ timeout = "10m"
579
+ ```
580
+
581
+ ## Global Options
582
+
583
+ | Option | Description |
584
+ | ----------------------------- | -------------------------------- |
585
+ | `--api-key TEXT` | API key for authentication |
586
+ | `--domain TEXT` | API server domain |
587
+ | `--protocol [http\|https]` | Protocol |
588
+ | `--timeout INTEGER` | Request timeout in seconds |
589
+ | `-o, --output [table\|json\|yaml]` | Output format |
590
+ | `--config PATH` | Config file path |
591
+ | `-v, --verbose` | Enable debug output |
592
+ | `--no-color` | Disable colored output |
593
+ | `--version` | Show version |
594
+
595
+ ## Output Formats
596
+
597
+ The CLI supports three output formats via the `-o` / `--output` flag:
598
+
599
+ - **`table`** (default) — Human-friendly tables powered by [Rich](https://github.com/Textualize/rich)
600
+ - **`json`** — Machine-readable JSON
601
+ - **`yaml`** — YAML output
602
+
603
+ ```bash
604
+ # Table (default)
605
+ osb sandbox list
606
+
607
+ # JSON for scripting
608
+ osb -o json sandbox list
609
+
610
+ # YAML
611
+ osb -o yaml sandbox list
612
+ ```
@@ -0,0 +1,22 @@
1
+ opensandbox_cli/__init__.py,sha256=sR5N6_mQZrXiQCk-bNl0b14y61_iJDikXE0kKMN5mmg,733
2
+ opensandbox_cli/__main__.py,sha256=k_LORG0-gcQ1vNZR9Nb-jZz3zC5tnKnrQT94IYsC6Vg,721
3
+ opensandbox_cli/client.py,sha256=zsZeoRQr1oH4YXzcACRgF8rXV2v3yTlDpZ55ATtt6Zw,6269
4
+ opensandbox_cli/config.py,sha256=3N5aGJD5MQR29vfMjxvOPh8hQJl3oq8D_1pQ4lv-XU0,4887
5
+ opensandbox_cli/main.py,sha256=klMMtQMfdg5i3hTHE7IP5oidm61IpANROmgSrWYvEAA,4766
6
+ opensandbox_cli/output.py,sha256=Gw9vO-wBcMn5whosMCMIx8_iDwfuNZTkVKxxPXv2s5Q,11707
7
+ opensandbox_cli/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
8
+ opensandbox_cli/utils.py,sha256=GtQGmDom7A4V7ajQMs3apx86L64z2tNi6TE7ISnPsno,4784
9
+ opensandbox_cli/commands/__init__.py,sha256=sdVsJCVaI4JWXHSYyR6fepcH75XHI9NK_ci0uCfWnQU,590
10
+ opensandbox_cli/commands/command.py,sha256=fNPnxrp4XkcI8FChKCODw39SlSRKVitEYlVeowZ_4Bg,9922
11
+ opensandbox_cli/commands/config_cmd.py,sha256=qm24qYXmGhyMUqCL75Ug_-fTkTYYeXO6DRQHZgToWJY,5380
12
+ opensandbox_cli/commands/devops.py,sha256=0ShNTZVkYep_O0EChl7h-w8KuWjYqRo5jnWLlkoqrw0,3898
13
+ opensandbox_cli/commands/egress.py,sha256=t0TXB9vAuLz_kWtttQPDIPzxThphn1LouYUT6CrCl-U,2881
14
+ opensandbox_cli/commands/file.py,sha256=LjBzt9IiCtDjLQzZoaAYI5bomSfGM83KEAR2eMGxBu0,11618
15
+ opensandbox_cli/commands/sandbox.py,sha256=4dPheNPZy9Xf0scr0BAMM1YhTGRNb70dgopDtiGPXik,12604
16
+ opensandbox_cli/commands/skills.py,sha256=mggcQjZUZ3Y1jDSfpzXGt9YqM-8jw5oZrTCYcg9W0Qk,8842
17
+ opensandbox_cli/skills/opensandbox-troubleshoot.md,sha256=EkWDpUh1Cej1hWrOHaDKBoBlU5hw4NVcYi4vx5yBT7Q,4585
18
+ opensandbox_cli-0.1.0.dev1.dist-info/METADATA,sha256=tllgPDPEbY17XXte_UAoW9yYYcDjQlWn154tAJqmE9o,25612
19
+ opensandbox_cli-0.1.0.dev1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
20
+ opensandbox_cli-0.1.0.dev1.dist-info/entry_points.txt,sha256=9N7alBHzpDym_CzarYLZXCNyQTjdpoOsOriFhoIPOIQ,88
21
+ opensandbox_cli-0.1.0.dev1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
22
+ opensandbox_cli-0.1.0.dev1.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.29.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ opensandbox = opensandbox_cli.main:cli
3
+ osb = opensandbox_cli.main:cli