alethe-agents

Name: alethe-agents
Author: Kc1t

Warning

A local-first desktop workspace for running, organizing, and resuming multiple coding agents and shells with real PTYs, split panes, persistent layouts, and local session history.

549stars

72forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/Kc1t/alethe-agents

Getting Started

Guides for using ai agents skills like alethe-agents.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 8/19/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "dompurify: DOMPurify: IN_PLACE hook removal leaves a detached subtree executable, causing XSS",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "mermaid: Mermaid configuration APIs allow prototype pollution",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "nanoid: nanoid: non-secure generators can loop indefinitely with negative size",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-08-19T04:35:53.771Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is alethe-agents?

alethe-agents is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Kc1t. A local-first desktop workspace for running, organizing, and resuming multiple coding agents and shells with real PTYs, split panes, persistent layouts, and local session history. It has 549 GitHub stars.

Is alethe-agents safe to use?

alethe-agents returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install alethe-agents?

Clone the repository with "git clone https://github.com/Kc1t/alethe-agents" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is alethe-agents written in?

alethe-agents is primarily written in TypeScript. It is open-source under Kc1t on GitHub, so you can review or fork the full source.

Are there alternatives to alethe-agents?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh alethe-agents against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

skills

by mattpocock

Skills for Real Engineers. Straight from my .agents directory.

250,518

agent-swarm web-design

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

[!IMPORTANT] Alethe is an early public release. The desktop app is free, open source, and local-first, not local-only: update checks and provider usage polling are on by default, while other network features are optional or action-triggered. Manual GitHub Gist Sync is already available; first-party hosted sync or cloud backup may be offered separately later. See the privacy and data-flow guide.

What Alethe Is

One agent in one terminal is easy. Five agents across three repositories is the actual job — and that is where terminal tabs stop working: sessions get lost, MCP servers drift out of sync between agents, and nobody knows which agent is doing what, where.

Alethe is a desktop workspace built for that. Every agent runs in a real PTY inside a persistent project layout, keeps its own session and history, and stays alive when you rearrange the UI. On top of that, Alethe manages the things agents share: their CLIs, their MCP servers, their skills, and the conversations you move between them.

Cross-platform (Windows, macOS, Linux), local-first, built with Tauri, Rust, React, and xterm.js. “Local-first” describes workspace persistence, not an internet-free guarantee; see docs/PRIVACY.md for current network defaults, credentials, and retention.

Supported Platforms

Agents

Agent	CLI
Claude Code	`claude`	Session resume, usage cards, local history
Codex	`codex`	Session resume, usage cards
GitHub Copilot CLI	`copilot`
Antigravity	`agy`	Usage cards
OpenCode	`opencode`	Session resume
Mimo	`mimo`
Freebuff	`freebuff`
Shell	pwsh / bash / zsh	The plain terminal, same pane model

Missing CLIs can be installed, updated, and uninstalled from inside Alethe — it probes the machine for Node, npm, WinGet, Scoop, and Chocolatey and offers only the methods that actually work there, preferring each vendor's official installer. Already-installed CLIs are discovered across PATH, registry, npm/pnpm/Volta/fnm/nvm/Bun/Cargo/Scoop/Chocolatey, and can be pointed at a custom path.

What It Does

Run agents in parallel

Projects, groups, and subgroups organize repositories; each open project becomes a container with its own panes.
One agent per pane, or several agents as sub-tabs inside the same pane — each with its own PTY, working directory, and session.
Auto, spotlight, sidebar, and custom grid layouts, editable directly on the grid.
Closing a container hides it; the process keeps running.

Keep the context

Sessions of Claude Code, Codex, and OpenCode resume after a crash or a restart.
Recent chats lists the conversations of a pane's working directory and reopens any of them.
A Claude Code conversation can be handed off to Codex (and back) through a locally redacted context packet — no copy-pasting the thread by hand. Redaction is best effort, so review the packet before starting the target agent.
Scrollback is persisted per PTY, so reattaching shows what happened before.

Manage what the agents share

MCP tab: every MCP server configured on the machine, grouped by server and showing which agents have it — read from Claude Code, Codex, OpenCode, and Antigravity configs. Add, remove, copy a server from one agent to another, search the official registry, and ask each agent to verify it can really reach a server. Every write is backed up, re-parsed, and committed atomically.
Skills tab: the skills installed for each agent, with links and shared stores resolved so a shared skill shows up once.
Graphify: a code graph of the project, served to the agents as an MCP server.

Stay in control

RAM readout in the title bar; disable a terminal or suspend a whole group to get memory back.
Git panel per project — status, stage, commit, branches, diffs in a pane — plus worktrees for parallel tasks.
Pull Request review: the merge panel finds the open GitHub PR for an agent worktree through the local gh CLI, opens its metadata, and can start an AI review inside the same isolated worktree — read-only, with no commits, pushes, merges, or GitHub comments. Squash-merging stays an explicit human action, blocked when the head SHA moved, the PR is a draft, or GitHub reports conflicts. No GitHub token is stored; authentication is delegated to gh.
Content panes beside the terminals: file explorer, Markdown, diffs, images, video, embedded browser.
Todos per project, isolated profiles, local backup export/import, 14 UI and terminal themes, EN and pt-BR.
Remote Control: an authenticated LAN web view, paired by QR code, to follow and answer agents from your phone. It is off by default and uses unencrypted HTTP/WebSocket transport on the LAN, so enable it only on a trusted network. Clean profiles are read-only; answering agents requires a separate input opt-in, and shell input has its own additional opt-in.
Spotify Now Playing, using your own Spotify app credentials in Preferences ▸ Spotify with http://127.0.0.1:8888/callback as the redirect URI. Current releases store those credentials in local profile files; see the privacy guide before exporting or sharing profile data.

Core Concepts


Group	A collection of projects that opens, collapses, and suspends together.
Project	A saved working context: terminals, layout, color, local state.
Container	The visible frame of an opened project. Closing it does not kill anything.
Pane	A terminal view inside a container.
Sub-tab	A separate agent or shell session inside the same pane.
PTY	The real backend process, alive independently of the UI.

Product Philosophy

A focused core with optional capabilities, closer to Obsidian than to a maximalist IDE. Non-essential features ship behind feature flags or opt-in settings, and a clean installation stays a first-class experience. Coherence over volume.

Install

Use the published installers from Releases.

[!WARNING] Windows builds are not code-signed yet, so Defender may flag alethe.exe as Trojan:Win32/Bearfoos.A!ml and quarantine it. The !ml suffix denotes a machine-learning heuristic rather than a publisher signature, and terminal-multiplexer behavior such as spawning child processes and creating PTYs can produce false positives. Verify that the download came from the official Releases page; do not bypass a warning for an artifact from another source.

To recover it: Windows Security → Virus & threat protection → Protection history → Actions → Restore, then add an exclusion for %LOCALAPPDATA%\Alethe (and src-tauri/target if you build from source). Reports of incorrect detection go to Microsoft Security Intelligence. macOS builds are not notarized yet either — right-click the app and choose Open to bypass Gatekeeper. Signing and notarization are on the [roadmap](#road