Metadata-Version: 2.4
Name: ctf-orchestrator
Version: 0.1.1
Summary: A CLI for streamlining workflows for Capture-The-Flag players, including tools for file management and environment interaction.
License: MIT
Author: Owen Tam
Author-email: owenhwtam@gmail.com
Requires-Python: >=3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: argcomplete (==3.6.2)
Requires-Dist: art (==6.5)
Requires-Dist: astroid (==3.3.11)
Requires-Dist: click (==8.2.1)
Requires-Dist: colorama (==0.4.6)
Requires-Dist: dill (==0.4.0)
Requires-Dist: isort (==6.0.1)
Requires-Dist: markdown-it-py (==4.0.0)
Requires-Dist: mccabe (==0.7.0)
Requires-Dist: mdurl (==0.1.2)
Requires-Dist: packaging (==25.0)
Requires-Dist: platformdirs (==4.4.0)
Requires-Dist: pygments (==2.19.2)
Requires-Dist: python-dotenv (==1.1.1)
Requires-Dist: rich (==14.1.0)
Requires-Dist: shellingham (==1.5.4)
Requires-Dist: tomlkit (==0.13.3)
Requires-Dist: typer (==0.16.1)
Requires-Dist: typing-extensions (==4.14.1)
Requires-Dist: userpath (==1.9.2)
Description-Content-Type: text/markdown

# `ctf_orchestrator`

**Usage**:

```console
$ ctforch [OPTIONS] COMMAND [ARGS]...
```

**Options**:

- `--install-completion`: Install completion for the current shell.
- `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
- `--help`: Show this message and exit.

**Commands**:

- `info`: Display information about the current...
- `cleanup`: Delete non-existing CTFs or challenges...
- `run`: Run a command in the current active CTF...
- `challenge`: Manage challenges tracked in the active CTF.
- `config`: Change configurations used.
- `ctf`: Manage CTFs tracked.

## `ctforch info`

Display information about the current stateuration and active CTF.

**Usage**:

```console
$ ctforch info [OPTIONS]
```

**Options**:

- `--help`: Show this message and exit.

## `ctforch cleanup`

Delete non-existing CTFs or challenges from the active CTF.

**Usage**:

```console
$ ctforch cleanup [OPTIONS]
```

**Options**:

- `--mode [ctf|chal]`: [required]
- `--help`: Show this message and exit.

## `ctforch run`

Run a command in the current active CTF directory or active challenge directory.

**Usage**:

```console
$ ctforch run [OPTIONS] COMMAND_AND_ARGS...
```

**Arguments**:

- `COMMAND_AND_ARGS...`: The command to execute, followed by its arguments. [required]

**Options**:

- `--help`: Show this message and exit.

## `ctforch challenge`

Manage challenges tracked in the active CTF.

**Usage**:

```console
$ ctforch challenge [OPTIONS] COMMAND [ARGS]...
```

**Options**:

- `--help`: Show this message and exit.

**Commands**:

- `add`: Add a CTF Challenge to the Active CTF.
- `activate`: Activate a CTF challenge in the active CTF
- `deactivate`: Deactivate the current active challenge in...
- `solve`: Mark a challenge (the active challenge by...

### `ctforch challenge add`

Add a CTF Challenge to the Active CTF.

**Usage**:

```console
$ ctforch challenge add [OPTIONS] CHAL_NAME CATEGORY
```

**Arguments**:

- `CHAL_NAME`: [required]
- `CATEGORY`: [required]

**Options**:

- `--points TEXT`: [default: 0]
- `--solved TEXT`: [default: False]
- `--auto-active TEXT`: [default: True]
- `--help`: Show this message and exit.

### `ctforch challenge activate`

Activate a CTF challenge in the active CTF

**Usage**:

```console
$ ctforch challenge activate [OPTIONS] CHAL_NAME
```

**Arguments**:

- `CHAL_NAME`: [required]

**Options**:

- `--help`: Show this message and exit.

### `ctforch challenge deactivate`

Deactivate the current active challenge in the active CTF

**Usage**:

```console
$ ctforch challenge deactivate [OPTIONS]
```

**Options**:

- `--help`: Show this message and exit.

### `ctforch challenge solve`

Mark a challenge (the active challenge by default) in the active CTF as solved.

**Usage**:

```console
$ ctforch challenge solve [OPTIONS]
```

**Options**:

- `--chal-name TEXT`
- `--flag TEXT`
- `--help`: Show this message and exit.

## `ctforch config`

Change configurations used.

**Usage**:

```console
$ ctforch config [OPTIONS] COMMAND [ARGS]...
```

**Options**:

- `--help`: Show this message and exit.

**Commands**:

- `setup`: Setup the configuration in the /.ctf-orch.&#x27;

### `ctforch config setup`

Setup the configuration in the /.ctf-orch.&#x27;

**Usage**:

```console
$ ctforch config setup [OPTIONS]
```

**Options**:

- `--help`: Show this message and exit.

## `ctforch ctf`

Manage CTFs tracked.

**Usage**:

```console
$ ctforch ctf [OPTIONS] COMMAND [ARGS]...
```

**Options**:

- `--help`: Show this message and exit.

**Commands**:

- `init`: Initialize a CTF directory.
- `activate`: Activate a CTF as the current active CTF.
- `deactivate`: Deactivate the current active CTF.

### `ctforch ctf init`

Initialize a CTF directory.

**Usage**:

```console
$ ctforch ctf init [OPTIONS] CTF_NAME
```

**Arguments**:

- `CTF_NAME`: [required]

**Options**:

- `--directory TEXT`: [default: C:\Users\user\Desktop\CTF-orchestra]
- `--auto-active TEXT`: [default: True]
- `--help`: Show this message and exit.

### `ctforch ctf activate`

Activate a CTF as the current active CTF.

**Usage**:

```console
$ ctforch ctf activate [OPTIONS] CTF_NAME
```

**Arguments**:

- `CTF_NAME`: [required]

**Options**:

- `--help`: Show this message and exit.

### `ctforch ctf deactivate`

Deactivate the current active CTF.

**Usage**:

```console
$ ctforch ctf deactivate [OPTIONS]
```

**Options**:

- `--help`: Show this message and exit.

