whatisgithub

What is workshadow?

futureuniant/workshadow — explained in plain English

Analysis updated 2026-05-18

42TypeScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

A local-first desktop work journal app (Tauri) with rich text entries, AI summarization, and cross-entry Q&A using your own API key.

Mindmap

mindmap
  root((WorkShadow))
    What it does
      Local work journal
      Rich text entries
      Folder tree
    Tech stack
      TypeScript
      Tauri
      Rust
    Use cases
      Daily task log
      Status report summaries
      Cross entry Q&A
    Audience
      Remote workers
      Individual contributors
    AI features
      Summarization
      Semantic search
      Bring your own API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a private daily work log of tasks, decisions, and blockers stored only on your machine.

USE CASE 2

Generate a written summary of selected journal entries for a status report or email update.

USE CASE 3

Ask questions across months of past entries and get an answer with links back to the source notes.

USE CASE 4

Search entries semantically by describing what you remember instead of exact keywords.

What is it built with?

TypeScriptTauriRustNode.js

How does it compare?

futureuniant/workshadowcodedgar/three-fenestrajavlonbek1233/-l-clat-culinaire
Stars424242
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity2/53/51/5
Audiencegeneraldevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires your own LLM API key or endpoint for AI features, no model is bundled.

AGPL-3.0: you can use and modify freely, but if you distribute modified versions or run it as a network service, you must release your source changes too.

So what is it?

WorkShadow is a local-first desktop work journal application written in TypeScript, built for people who want to keep detailed records of their daily work, decisions, and progress without storing that data in the cloud. The README is written primarily in Chinese. The application runs as a desktop program using the Tauri framework, which bundles a web frontend with a lightweight native shell. The core feature is a rich text editor on the right side of the screen, where you write journal entries covering tasks, decisions, problems, and notes. Entries support headings, lists, task checkboxes, code blocks, tables, links, images, and video. On the left side is a tree of folders and entries for organizing your journal. Entries are saved to your local machine, not to any external server. Search comes in two forms. Keyword search matches text across all entries and shows preview snippets. Semantic search is available when you connect your own embedding model in the settings, letting you search by describing what you remember rather than typing exact words. The AI features are handled through a workbench panel. You can select multiple journal entries and ask the app to generate a written summary for reports, emails, or updates. You can also ask questions across your entire journal history, and the app will retrieve relevant entries and synthesize an answer with source references. Both features require you to configure your own language model by supplying an API endpoint and key in the settings. No model is bundled in. The repository offers two versions. The developer build can be compiled from source with Node.js and Rust installed. The installer build is a prebuilt Windows executable that includes performance optimizations, image drag-and-drop, and a local autocomplete feature that learns from your own past entries over time. Both versions are free and store all data locally. Backup and migration work through a custom .ws archive format. The code is released under AGPL-3.0.

Copy-paste prompts

Prompt 1
Help me set up WorkShadow with an OpenAI-compatible API key for the AI summary and Q&A features.
Prompt 2
Write a template journal entry structure I can reuse daily in WorkShadow for tasks, decisions, and blockers.
Prompt 3
Summarize my last two weeks of WorkShadow entries into a status update for my manager.
Prompt 4
Explain how to configure a local embedding model for WorkShadow's semantic search.

Frequently asked questions

What is workshadow?

A local-first desktop work journal app (Tauri) with rich text entries, AI summarization, and cross-entry Q&A using your own API key.

What language is workshadow written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, Rust.

What license does workshadow use?

AGPL-3.0: you can use and modify freely, but if you distribute modified versions or run it as a network service, you must release your source changes too.

How hard is workshadow to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is workshadow for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.