Skip to content

Releases: SourceOS-Linux/TurtleTerm

TurtleTerm turtle-term-v0.4.0

21 Jun 02:11

Choose a tag to compare

TurtleTerm turtle-term-v0.4.0 — native Linux packages.

TurtleTerm turtle-term-v0.3.0

21 Jun 01:39

Choose a tag to compare

TurtleTerm turtle-term-v0.3.0 — see CHANGELOG for details.

TurtleTerm turtle-term-v0.2.0

20 Jun 21:53

Choose a tag to compare

TurtleTerm turtle-term-v0.2.0 — see CHANGELOG for details.

TurtleTerm v0.1.1 — Agent-First Terminal Fabric

20 Jun 00:09

Choose a tag to compare

TurtleTerm v0.1.1

TurtleTerm is the SourceOS agent-first terminal workbench: policy-aware command execution, Noetica cognition loop integration, SynapseIQ language intelligence, MCP server for Claude Code, and complete shell event streaming.

What's new in v0.1.1

This is the first full release of the TurtleTerm SourceOS agent layer, built on the WezTerm GPU-accelerated terminal substrate.

Track A — Shell Events

  • turtle-agentd: local agent gateway with NDJSON event stream (sourceos.terminal.event.v0) and JSON receipt files
  • Shell hook integrations for bash, zsh, and fish — emits command.started / command.completed events on every command
  • Secret redaction (API keys, SSH private keys, tokens) before events are persisted
  • Execution domain detection (host, container, distrobox, ssh, k8s)
  • Git context enrichment (repo root + branch) attached to every event

Track B — Noetica Integration

  • turtle-agentctl noetica-status / noetica-query <text> — connect to Noetica /api/chat in sourceos mode
  • Superconscious observe/propose now forwards to Noetica with full session context
  • Buffer context injection in the Neovim plugin (file, line, col) attached to observations

Track C — MCP Server

  • turtle-mcp-server: 11-tool JSON-RPC 2.0 MCP server for Claude Code / Cursor / VS Code
  • Tools: terminal_sessions, terminal_inspect, terminal_summarize, terminal_propose, terminal_receipts, language_diagnostics, language_symbols, noetica_status, noetica_query, policy_status, policy_evaluate

Track D — Policy Fabric

  • turtle-agentctl policy-status — check Policy Fabric reachability and mode
  • Every request_execution / request_surface_execution call evaluated against Policy Fabric
  • allow / deny / ask / defer decisions persisted in receipt files as policy_decision_id
  • TURTLE_POLICY_MODE=enforcing to block denied commands

Track E — SynapseIQ + Neovim

  • turtle-language hover --line N --character N — hover information via SynapseIQ LSP
  • turtle-language synapseiq-status — check SynapseIQ reachability
  • diagnostics and symbols route to SynapseIQ first, fall back to built-in heuristics
  • Neovim: :TurtleNoeticaStatus, :TurtleNoeticaQuery, :TurtlePolicyStatus, :TurtleHover, :TurtleSynapseIQStatus

Track F — Release

  • Homebrew tap: brew install SourceOS-Linux/tap/turtleterm
  • CI: Python layer smoke tests, script syntax checks, trust surface validation, security checks, Linux packaging validation
  • TRUST_SURFACE.yaml declaring known risks and compensating controls
  • SBOM (SPDX) for all four platform builds

Artifacts

Platform Format File
macOS arm64 tarball turtle-term-turtle-term-v0.1.1-macos-arm64.tar.gz
macOS x86_64 tarball turtle-term-turtle-term-v0.1.1-macos-x86_64.tar.gz
Linux x86_64 tarball turtle-term-turtle-term-v0.1.1-linux-x86_64.tar.gz
Linux arm64 tarball turtle-term-turtle-term-v0.1.1-linux-arm64.tar.gz
Linux amd64 .deb turtle-term_0.1.1_amd64.deb
Linux arm64 .deb turtle-term_0.1.1_arm64.deb
Linux x86_64 .rpm turtle-term-0.1.1-1.x86_64.rpm
Linux aarch64 .rpm turtle-term-0.1.1-1.aarch64.rpm
Linux x86_64 .pkg.tar.zst turtle-term-0.1.1-1-x86_64.pkg.tar.zst
Linux aarch64 .pkg.tar.zst turtle-term-0.1.1-1-aarch64.pkg.tar.zst

All artifacts include .sha256 checksums, .manifest.json metadata, and SPDX SBOM attestations.

Quick start

# Homebrew
brew tap SourceOS-Linux/tap
brew install turtleterm

# Shell integration (add to ~/.zshrc)
source "$(brew --prefix turtleterm)/share/turtleterm/shell/turtle-shell-init.zsh"

# Claude Code MCP (~/.claude/settings.json)
# "mcpServers": { "turtleterm": { "type": "stdio", "command": "turtle-mcp-server" } }

# Verify
turtle-agentctl --stdio ping
turtle-agentctl --stdio noetica-status
turtle-agentctl --stdio policy-status
turtle-language synapseiq-status

Environment

Variable Default Purpose
SOURCEOS_NOETICA_URL http://localhost:8080 Noetica cognition loop
SOURCEOS_POLICY_FABRIC_URL http://localhost:8081 Policy Fabric
SOURCEOS_SYNAPSEIQ_URL http://localhost:2087 SynapseIQ LSP
TURTLE_POLICY_MODE report_only report_only or enforcing
TURTLE_AGENTD_SOCKET auto Unix socket path for agentd