Metadata-Version: 2.3
Name: nimbie-shell
Version: 0.0.3.dev0
Summary: Lightweight agent loop and context manager (standalone)
Requires-Dist: click>=8.1.7
Requires-Dist: httpx[http2]>=0.28.1
Requires-Dist: litellm>=1.81.11
Requires-Dist: chronml>=0.1.0
Requires-Dist: oturn>=0.1.0
Requires-Dist: nimbie-flash>=0.0.3.dev0
Requires-Dist: prompt-toolkit>=3.0.39
Requires-Dist: rich>=13.7.0
Requires-Dist: textual>=0.80.0
Requires-Dist: asyncssh>=2.13.1
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn[standard]>=0.30.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# nimbie

`nimbie` is a terminal-first coding assistant shell.

This repository now contains two main parts:

- `nimbie` (root package): REPL/UI, command tools, shell execution flow, session UX
- `oturn` (sub-package): standalone async orchestration/runtime core for agent turns

## Repository Layout

- `src/nimbie`: CLI app and terminal UI
- `oturn/src/oturn`: reusable orchestration package
- `chron`: chronml package used for message/config templating
- `flash`: shell runtime bridge and executor components

## Requirements

- Python `>=3.10`
- `uv` (recommended)

## Install (Root CLI)

```bash
uv sync
uv pip install -e .
```

Run:

```bash
nimbie --help
uv run nimbie --help
```

## Install (`oturn` only)

If you only want the orchestration package:

```bash
cd oturn
uv sync
uv pip install -e .
```

## Build

Root package:

```bash
uv build
```

`oturn` package:

```bash
cd oturn
uv build
```

## Config

The CLI loads config from (first match wins by runtime path logic):

- `~/.nimbie/config.py`
- `~/.nimbie/config.json`
- `~/.openclaw/openclaw.json`
- `.nimbie_config.py`
- `.nimbie_config.json`

## Session and History

- Session artifacts are stored under `.nimbie/` in the workspace/global locations used by CLI.
- The UI supports continue/list/export workflows via CLI flags and REPL commands.

## Notes

- Flash runtime is expected for shell parsing/execution flow.
- `oturn` does not use global auto tool registry; tools are injected explicitly at runtime.
