> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nika.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# shell

> Contract, placement, related fields and source examples for this Nika YAML field.

[Language reference](https://docs.nika.sh/reference/language/overview.md) / `shell`

## Meaning and placement

### exec

One shell line, run via /bin/sh -c — the EXPLICIT dangerous door (pipes · redirects · globs). The blocklist applies here; interpolating untrusted values here is on the author. Exactly one of command|shell.

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/$defs/exec/properties/shell` |
| type | `"string"` |
| minLength | `1` |

**In the same object:** [capture](https://docs.nika.sh/reference/language/words/capture.md) · [command](https://docs.nika.sh/reference/language/words/command.md) · [cwd](https://docs.nika.sh/reference/language/words/cwd.md) · [decode](https://docs.nika.sh/reference/language/words/decode.md) · [env](https://docs.nika.sh/reference/language/words/env.md) · [stdin](https://docs.nika.sh/reference/language/words/stdin.md)

[Schema source (use the pointer above)](https://github.com/supernovae-st/nika-spec/blob/4e259e5b8012fcdf92f094142a52dfef24099b85/schemas/workflow.schema.json)

## Examples

No matching source-template occurrence is recorded in this projection. [Write a workflow](https://docs.nika.sh/guides/templates.md) or consult the schema declaration above.

## Contract and implementation

This page projects the named specification revision. Check [released engine status](https://docs.nika.sh/reference/status.md) and [the validation workflow](https://docs.nika.sh/guides/agent-authoring.md) before running a file. An optional field is not evidence that every engine supports every value.

Canonical identity: `language:word:shell`. Spec revision: [`4e259e5b8012`](https://github.com/supernovae-st/nika-spec/tree/4e259e5b8012fcdf92f094142a52dfef24099b85).

[How documentation stays connected](https://docs.nika.sh/reference/knowledge-system.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.