NeverWrite  by jsgrrchg

Local-first knowledge workspace for agentic workflows

Created 2 months ago
713 stars

Top 47.3% on SourcePulse

GitHubView on GitHub
Project Summary

NeverWrite offers a local-first knowledge workspace, merging a code editor-like Markdown experience with multi-agent AI workflows. It targets power users needing robust change control and parallel agent management, providing a unified environment for notes, code, and data with an emphasis on transparent AI interactions.

How It Works

The project employs an Electron desktop application with a Rust sidecar for local vault management. It utilizes CodeMirror 6 for a rich Markdown, CSV, and text/code editing experience, featuring wikilinks and live previews. A core differentiator is its ACP-based AI layer (Codex, Claude, Gemini, Kilo) integrated with an explicit AI change-review system, ensuring all AI-generated edits are user-reviewable via inline controls and a dedicated review tab, preventing silent modifications.

Quick Start & Requirements

  • Desktop App: cd apps/desktop && npm install && npm run dev
  • Web Clipper: cd apps/web-clipper && pnpm install && pnpm dev
  • Prerequisites: Rust/Cargo, Node.js 22+, pnpm (v10.33.0 for web clipper).
  • Local API: Web clipper communicates via http://127.0.0.1:32145.
  • Dev Origins: For development, specify allowed origins via NEVERWRITE_WEB_CLIPPER_DEV_ORIGINS.
  • Docs: GitHub Discussions for custom ACP implementation: https://github.com/jsgrrchg/NeverWrite/discussions/17

Highlighted Details

  • Local-first knowledge workspace with Electron/React frontend and Rust backend.
  • Supports Markdown, CSV, PDF, images, and generic text/code files within a unified workspace.
  • AI change-control layer with inline review, accumulated action logs, and a dedicated review tab.
  • Integrated web clipper (Firefox/Chromium) with direct desktop save via local API or deep-link fallback.
  • Advanced knowledge navigation tools including backlinks, tags, search, and 2D/3D graph views.

Maintenance & Community

The project is in a "polish and hardening phase" and actively seeking community contributions, particularly for Linux support and bug identification. The developer is committed to long-term improvement.

Licensing & Compatibility

Licensed under Apache-2.0. This license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

The project is pre-1.0, indicating ongoing development and potential for edge cases. The 3D graph view has known memory leaks, requiring application restarts after use. The developer is actively seeking help to resolve these issues.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
64
Issues (30d)
24
Star History
53 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.