Documentation Index
Fetch the complete documentation index at: https://mintlify.com/TheNextLvl-net/cinematics/llms.txt
Use this file to discover all available pages before exploring further.
The delete subcommand removes a named recording from the server’s storage. Once deleted, the recording can no longer be played back with /cinematic play or inspected with /cinematic info. The file is erased from the plugin’s data folder on disk.
Syntax
Arguments
| Argument | Type | Required | Description |
|---|
name | string | ✅ Yes | The identifier of the recording to delete. Tab-completion suggests names of all recordings currently saved on the server. |
Behaviour
- Lookup — The plugin resolves the recording file that corresponds to
<name>. If no matching file is found, execution halts and a record-not-found message is sent.
- Delete — The plugin attempts to remove the file from disk.
- Success — If the file is deleted successfully, a confirmation message is sent to the caller.
- Failure — If the file exists but could not be removed (for example, due to a file-system permission error), a failure message is sent instead.
Permission
| Permission node | Default |
|---|
cinematics.command.cinematic | op |
Error Messages
| Key | When sent | Default text |
|---|
record-not-found | No recording with the given name exists on disk | Cinematics » A record with this name does not exist |
Deletion is permanent and cannot be undone. The recording file is removed directly from disk with no backup or recycle mechanism. Ensure you genuinely no longer need the recording before running this command.