> ## 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.

# env

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

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

## Meaning and placement

### → permits

Engine env names passed through to child processes · exact POSIX names, no globs · composed with the runner env floor, never inherited (spec/01-envelope.md §permits · NEP-0005). An interpolated entry passes the shape gate and is refused as a non-literal bound (NIKA-AUTH-007).

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/properties/permits/properties/env` |
| type | `"array"` |

**In the same object:** [exec](https://docs.nika.sh/reference/language/words/exec.md) · [fs](https://docs.nika.sh/reference/language/words/fs.md) · [net](https://docs.nika.sh/reference/language/words/net.md) · [tools](https://docs.nika.sh/reference/language/words/tools.md)

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

### exec

OS environment variables for THIS subprocess · a key→value map applied over the composed environment. Nothing is inherited — the ambient environment reaches a task only through `permits.env` (spec/01-envelope.md §permits).

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/$defs/exec/properties/env` |
| type | `"object"` |
| additionalProperties | declaration below |

<details>
  <summary>`additionalProperties` schema declaration (spec source, not a lesson)</summary>

  ```json theme={"system"}
  {
    "type": "string"
  }
  ```
</details>

**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) · [shell](https://docs.nika.sh/reference/language/words/shell.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/5c40ba456c53a4ab663a949d44003078e161305d/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:env`. Spec revision: [`5c40ba456c53`](https://github.com/supernovae-st/nika-spec/tree/5c40ba456c53a4ab663a949d44003078e161305d).

[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.