kraken-rs - GitLite

KO | EN

gitlite — search

#terminal #nlp #tensorflow #tailwindcss #markdown #github #vue #awesome #ui #windows

kraken-rs

(★ 9)

No description available.

파일 탐색기

ZIP 다운로드

- - kraken-qa.ts
- - BerkeleyMonoNerdFontMono-Medium.ttf
  - InstrumentSans.ttf
- - ai.rs
  - drive.rs
  - mod.rs
  - native_menu.rs
  - palette.rs
  - state.rs
- - backend.rs
  - cache.rs
  - mod.rs
  - models.rs
  - runner.rs
  - store.rs
- - mod.rs
  - offscreen.rs
  - slab.rs
  - window.rs
- - avatars.rs
  - layout.rs
  - mod.rs
- - grid.rs
  - hole.rs
  - mod.rs
  - pty.rs
- - action.rs
  - geometry.rs
  - highlight.rs
  - icons.rs
  - layout.rs
  - menu.rs
  - mod.rs
  - slab.rs
  - text_field.rs
- main.rs
- settings.rs
- app.slab
- controls.slab
- detail.slab
- diff.slab
- graph.slab
- icons.slab
- overlays.slab
- preferences.slab
- sidebar.slab
- statusbar.slab
- terminal.slab
- theme.slab
- topbar.slab
- welcome.slab
- wip.slab
.gitignore
AGENTS.md
bun.lock
Cargo.lock
Cargo.toml
codicon_mapping.json
package.json
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Kraken Native is a native Git desktop client whose UI is authored in Slab, solved by the shared Rust Slab kernel, and painted with `wgpu`; no browser or web view is embedded in the application shell.

The project is under active development. Core local Git workflows are real repository operations, while the hosted-service surfaces listed under [Current boundaries](#current-boundaries) are not connected.

## Current capabilities

- Discover, open, create, and clone repositories; search recent repositories and keep multiple repositories in tabs.
- Browse a virtualized topological commit graph with stable lanes, merge curves, branch and tag labels, WIP rows, linked-worktree state, search, and resizable columns.
- Inspect commit metadata, parent links, conflicts, changed paths, and complete commit trees.
- Stage or unstage individual files, all files, or selected diff lines; discard selected unstaged lines; create, amend, and optionally push commits.
- Read inline or split diffs with aligned lines, syntax highlighting, intraline marks, staged/unstaged scopes, search, hunk navigation, a change minimap, text selection, and full-file views.
- Create, check out, rename, and delete branches; create, check out, and delete tags; apply, pop, and drop stashes.
- Fetch, pull with selectable integration behavior, push, fast-forward, merge, rebase, cherry-pick, revert, and reset.
- Undo and redo recorded commit, checkout, reset, and branch mutations.
- Use an in-app PTY terminal, command palettes, notifications, persisted preferences, commit profiles, SSH settings, commit signing, external tools, Gitflow, Git LFS, and sparse checkout.
- Render deterministic offscreen PNGs and expose a loopback automation endpoint for semantic UI driving.
- Request commit explanations or rewritten commit messages from an optional HTTP AI provider.

## Requirements

- Rust 1.85 or newer (the crate uses Rust 2024 edition).
- Network access on first build: the `slab-*` crates are fetched from `https://github.com/stencil-hq/slab.git`. No sibling checkout is required; see [Local Slab development](#local-slab-development) to build against one.
- A desktop and graphics backend supported by `winit` and `wgpu`.
- Git on `PATH` for CLI-backed features such as signed commits, Gitflow, sparse checkout, and Git LFS operations.
- Optional: Git LFS and GPG for their respective workflows.

## Run

Open a repository explicitly:

```sh
cargo run --release -- --repo /path/to/repository
```

If `--repo` is omitted, Kraken discovers a repository from the current directory. When discovery fails, it opens the welcome screen, where repositories can be opened, created, or cloned.

Build and run the binary directly:

```sh
cargo build --release
./target/release/kraken --repo /path/to/repository
```

See every command-line option with:

```sh
cargo run -- --help
```

## Deterministic rendering

Render a view to a PNG without opening a window:

```sh
cargo run --release -- \
  --repo /path/to/repository \
  --screenshot graph \
  --out graph.png \
  --width 1600 \
  --height 900
```

Available views are `graph`, `wip`, `diff`, `file`, `preferences`, and `tabs`. Output defaults to `kraken.png`; the default render size is 2404 by 1354 physical pixels.

Start the headless semantic automation endpoint with:

```sh
cargo run --release -- --repo /path/to/repository --automation-port 0
```

The server binds to loopback only. Port `0` selects an available port; startup prints an `Automation.ready` JSON message containing the host, selected port, and protocol version.

## Optional AI provider

AI requests require both an endpoint and API key:

| Variable | Meaning |
|---|---|
| `KRAKEN_AI_ENDPOINT` | HTTP endpoint accepting a chat-completion-shaped JSON request |
| `KRAKEN_AI_API_KEY` | Bearer token sent to the endpoint |
| `KRAKEN_AI_MODEL` | Optional model name; defaults to `claude-sonnet-4-6` |

Example:

```sh
KRAKEN_AI_ENDPOINT=https://example.test/v1/chat/completions \
KRAKEN_AI_API_KEY=secret \
KRAKEN_AI_MODEL=my-model \
cargo run --release -- --repo /path/to/repository
```

Without both required variables, the UI reports that the provider is unconfigured and sends no request.

## Development

Run the repository test suite:

```sh
cargo test
```

Check all targets without producing binaries:

```sh
cargo check --all-targets
```

### Local Slab development

To compile against a live `../slab-lang` checkout instead of the pinned git dependency, create a gitignored `.cargo/config.toml`:

```toml
[patch."https://github.com/stencil-hq/slab.git"]
slab-kernel = { path = "../slab-lang/crates/slab-kernel" }
slab-fonts = { path = "../slab-lang/crates/slab-fonts" }
slab-native = { path = "../slab-lang/crates/slab-native" }
slab-slir = { path = "../slab-lang/crates/slab-slir" }
slab-macro = { path = "../slab-lang/crates/slab-macro" }
```

Delete the file to build from GitHub again.

### Architecture

| Path | Responsibility |
|---|---|
| `src/app/` | Event loop, application state, automation protocol, AI worker, command palette, and native menus |
| `src/git/` | Repository models, `libgit2` backend, filesystem watching, and background Git worker |
| `src/graph/` | Commit-lane layout and avatar loading |
| `ui/app.slab` | Authoritative shell, graph, WIP, detail, diff, preferences, welcome, and overlay UI |
| `src/ui/slab.rs` | `slab_macro::include_doc!` compilation of `ui/app.slab`, `AppState` projection, authored signal routing, and interaction contract tests |
| `src/ui/layout.rs` | Panel-rect and column/section layout math shared by slab constraints and state |
| `src/ui/` | Slab integration plus retained actions, geometry, menu model, and text-field values |
| `src/gpu/` | Windowed and offscreen `wgpu` renderers, including the Slab frame painter |
| `src/term/` | PTY process management and terminal-grid parsing |
| `src/settings.rs` | Platform-native TOML settings persistence |

Repository work runs off the window event loop. Each Git job opens a fresh repository handle, and versioned results prevent stale background responses from replacing newer UI state.

## Current boundaries

- Pull request, issue, team, organization, and cloud-patch sections are visual shell entries, not hosted-service integrations.
- There is no conflict-resolution editor or interactive rebase editor.
- File History currently presents the selected diff in a history layout; it does not enumerate revisions for the path.
- Linked worktrees are discovered and monitored, but the UI does not create or open worktrees.