kitkit-cli

KO | EN

gitlite — search

#rag #sql #codex #containers #nextjs #tailwindcss #cli #react #rust #nlp

(★ 9)

Command-line access to KitKit spaces, conversation topology, session digests, insight push, shared memory, and forks.

File Explorer

ZIP Download

- - release.yml
- - auth.rs
  - client.rs
  - error.rs
  - lib.rs
  - sessions.rs
  - shared_memory.rs
  - spaces.rs
- - live_api.rs
- Cargo.toml
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- api_client.rs
- auth.rs
- auth_store.rs
- cli.rs
- input.rs
- main.rs
- output.rs
- session.rs
- shared_memory.rs
- space.rs
.gitignore
Cargo.lock
Cargo.toml
CHANGELOG.md
install.ps1
install.sh
LICENSE
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

*Currently WIP*

Command-line access to KitKit spaces, conversation topology, session digests,
insight push, shared memory, and forks.

The CLI is intended for agents such as Codex and Claude Code that need to act as
a KitKit "main" process: inspect a whole conversation tree, read shared context,
push insights to sessions, and create new fork nodes.

## Skills

Reusable agent skills live in `skills/`:

- `kitkit-cli`: KitKit mental model, auth, shared memory, and base CLI workflow.
- `kitkit-conversation-tree`: topology and targeted digest reading.
- `kitkit-insight`: cross-session insight push workflow.
- `kitkit-fork`: fork creation and context-mode selection.
- `kitkit-as-kitty`: high-level Kitty role that composes the lower-level skills.

## TODOs

- [ ] documentation refined

## Build

```bash
cargo build
```

## Install

Linux and macOS use the same shell installer:

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/stello-agent/kitkit-cli/main/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://raw.githubusercontent.com/stello-agent/kitkit-cli/main/install.ps1 | iex
```

To pin a release:

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/stello-agent/kitkit-cli/main/install.sh | sh -s -- --version v0.1.1
```

```powershell
$env:KITKIT_VERSION = "v0.1.1"; irm https://raw.githubusercontent.com/stello-agent/kitkit-cli/main/install.ps1 | iex
```

## Authentication

```bash
kitkit-cli auth login
```

Or pass the email and read the password from stdin:

```bash
printf '%s' "$KITKIT_PASSWORD" \
  | kitkit-cli auth login --email "$KITKIT_EMAIL" --password-stdin
```

The CLI stores access and refresh tokens in the platform config directory via
the `directories` crate:

- Linux: `$XDG_CONFIG_HOME/kitkit-cli/auth.json`, or `~/.config/kitkit-cli/auth.json`
- macOS: `~/Library/Application Support/com.kitkit-agent.kitkit-cli/auth.json`
- Windows: `%APPDATA%\kitkit-agent\kitkit-cli\config\auth.json`

On Unix, the token file is created with `0600` permissions.

Check login state:

```bash
kitkit-cli auth status
```

Remove cached tokens:

```bash
kitkit-cli auth logout
```

## Output

Human-readable output is the default:

```bash
kitkit-cli spaces list
```

Every command supports JSON output:

```bash
kitkit-cli --json spaces list
kitkit-cli --json digest <space-id> <session-id>
```

JSON output is produced from the strongly typed SDK response structs.

## Commands

See `--help`

## License

MIT OR Apache-2.0

kitkit-cli

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

kitkit-cli

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README