ascend-tools-cli 1.0.0

CLI for the Ascend Instance web API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# ascend-tools-cli

CLI for the [Ascend](https://www.ascend.io) Instance web API. Installs as the `ascend-tools` binary.

Built on [`ascend-tools-core`](../ascend-tools-core). Also embeds [`ascend-tools-mcp`](../ascend-tools-mcp) for the `mcp` subcommand and [`ascend-tools-tui`](../ascend-tools-tui) for the `otto tui` interactive chat.

## Install

```bash
cargo install ascend-tools-cli
```

Or via Python:

```bash
uv tool install ascend-tools
```

## Usage

```
ascend-tools [-o text|json] [-V]

  workspace list [--environment <NAME>] [--project <NAME>]
  workspace get <TITLE>
  workspace create --title <TITLE> --environment <NAME> --project <NAME> --profile <NAME> --git-branch <BRANCH>
  workspace update <TITLE> [--title, --git-branch, --profile, --size, --storage-size]
  workspace pause <TITLE>
  workspace resume <TITLE>
  workspace delete <TITLE>

  deployment list [--environment <NAME>] [--project <NAME>]
  deployment get <TITLE>
  deployment create --title <TITLE> --environment <NAME> --project <NAME> --profile <NAME> --git-branch <BRANCH>
  deployment update <TITLE> [--title, --git-branch, --profile, --size, --storage-size]
  deployment pause-automations <TITLE>
  deployment resume-automations <TITLE>
  deployment delete <TITLE>

  environment list
  environment get <TITLE>

  project list
  project get <TITLE>

  profile list --workspace <TITLE> | --deployment <TITLE> | --project <NAME> --git-branch <BRANCH>

  flow list --workspace <TITLE> | --deployment <TITLE>
  flow run <FLOW_NAME> --workspace <TITLE> | --deployment <TITLE> [--spec '{}'] [--resume]
  flow list-runs --workspace <TITLE> | --deployment <TITLE> [--status, --flow, --since, --until, --offset, --limit]
  flow get-run <RUN_NAME> --workspace <TITLE> | --deployment <TITLE>

  otto run <PROMPT> [--workspace <TITLE>] [--provider <ID>] [--model <ID>]
  otto provider list
  otto model list [--provider <ID>]
  otto tui [--workspace <TITLE>]

  mcp [--http] [--bind <ADDR>]
  skill install --target <PATH> [--cli] [--python] [--mcp] [--all]
```

## Authentication

```bash
export ASCEND_SERVICE_ACCOUNT_ID="asc-sa-..."
export ASCEND_SERVICE_ACCOUNT_KEY="..."
export ASCEND_INSTANCE_API_URL="https://api.instance.ascend.io"
```

Auth can also be passed via `--service-account-id`, `--service-account-key`, and `--instance-api-url` flags.

See the [top-level README](../../../README.md) for full documentation.