kiss-agent 0.1.9

Terminal-based stupid assistant

kiss-agent

An experimental terminal-based coding assistant.

Context

Experimental AI agent written in python. Goal is just for personal use and learning lessons only.

Quick Start

Installation

Requires Python 3.12+.

With pip:

pip install kiss-agent

With uv:

uv tool install kiss-agent

First Run

Start the app, then connect a provider from inside the UI:

kiss

Run /connect to authenticate a provider, then /model to pick the model you want to use.

If you prefer environment variables, you can still set provider credentials manually and then use /model.

settings.jsonc.example is an advanced reference for optional settings. It is not the recommended first-run path.

Usage

kiss                               # Rich UI (default)
kiss "Explain this codebase"       # headless
kiss --headless "Summarize this"   # explicit headless mode

Documentation

• Architecture Overview: High-level technical design.
• Capabilities Overview: Overview of what the agent can do.
• Configuration Reference: Detailed settings and CLI flags.
• Tool System & Permissions: How agents interact with your files.
• Agent Loop: Details on the core execution and streaming.
• Turn Engine & Phases: Deep dive into the unified turn engine and phase flow.
• Context Compaction: How history and tokens are managed.
• Observability: Tracing and local diagnostics.
• Terminal UI: Rich and Textual backend design and parity rules.

License

MIT — do whatever you want with this stupid agent.