koshi0.1.0
Using koshi

Logging

Enable per-session pretty or JSON logs without recording terminal input or copied text.

Logging is off by default. When enabled, koshi writes one file per session:

logs/koshi-log-<session-id>.log

The logs/ directory lives below koshi's platform state directory. Disabled logging creates no file.

Configure

koshi.kdl
version 1

logging {
    enabled #true
    level "warning"
    format "pretty"
}
SettingValuesDefault
enabled#true / #false#false
level"info" / "warning" / "error""warning"
format"pretty" / "json""pretty"

info includes normal lifecycle events. warning adds recoverable problems. error keeps only failures that stop koshi. Each level includes more severe events.

pretty is human-readable. json writes one JSON object per line for tools to parse.

Privacy

Logs include ids, lifecycle events, errors, and byte counts. They do not store typed input or copied terminal text.

Remove old logs with the platform cleanup steps on the Uninstall page.

On this page