# commands reference

katton registers **your** commands as subcommands via, `/katton run`

| command | what it does |
|---|---|---|
| `/katton import` | imports or replaces one of **your own** scripts |
| `/katton export <name>` | exports one of your own scripts as a token |
| `/katton run <cmd> [args...]` | runs one of your own script commands |
| `/katton scripts` | lists your own scripts |
| `/katton diagnose <name>` | shows compile/runtime diagnostics |
| `/katton delete <name>` | deletes one of your own scripts (run twice to confirm) |

### `/katton run` in detail

```
/katton run <command name> [arguments...]
```

script commands are completely private per owner, you aren't able to run other players scripts, unless they share the code/token with you to import

```csharp
@Katton.command(name = "apple", permission = "all")
function giveApple(sender, args) {
    sender.give(Katton.item("apple"))
}
```

```
/katton run apple
```

anything after the command name becomes the `args` list, see [variables & values](../language/variables-and-values.md) for how that works, and [command annotation](../api/command-annotation.md) for the full annotation rules
