Skip to content
lobbystackPublic

About

The open workspace for humans and AI. Local-first notes, tasks, and projects in ordinary files, with optional end-to-end encrypted sync.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

74 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

noura

The open workspace for humans and AI.

noura is an open-source, local-first desktop workspace for notes, tasks, projects, and AI chat. Your work stays in ordinary files you can edit, back up, and use without noura.

Status: Local Alpha Continuous integration License: MIT

Try noura · Documentation · Contribute

A workspace built from plugins

Files and the Markdown editor are always on. Tasks, projects, calendar, and AI are first-party plugins. Each runs as a WebAssembly component with only the capabilities you approve, and you turn plugins on for each workspace in Settings > Plugins.

Turning a plugin off leaves its files in place. You can also install plugins from a folder or from GitHub, or write your own in TypeScript or Rust.

Work in one workspace

Write project notes, track tasks, and give your AI assistant context from the same workspace:

  • Notes: write and edit Markdown, and open PDFs and images beside them
  • Tasks and projects: track priorities, due dates, and progress on project boards
  • Calendar: view scheduled work by month, week, or day
  • Search: find content across your workspace with full-text search
  • AI chat: connect your provider, allow it to read workspace content, and approve each tool call
  • External AI tools: read and update notes and tasks through the Model Context Protocol (MCP). noura doesn't ask before each MCP action, so connect only tools you trust.

Keep control of your work

Use noura alongside your existing tools:

  • Open files: notes, tasks, projects, and chat history stay Markdown files with structured metadata
  • Local use: read and edit your workspace offline, without an account or hosted service
  • External editing: edit, move, and rename files with other tools, and review conflicts when changes overlap
  • AI permissions: choose your provider, and allow it to read workspace content before the first request
  • Credentials: noura keeps provider keys in your operating system's credential store
  • Sync: turn on end-to-end encrypted sync for a workspace with a sync server, which stores ciphertext and the metadata it needs to route it

Try noura

Download the installer for macOS, Windows, or Linux from noura.app or the releases page. noura is an early alpha, so keep backups of important files.

Run noura from source

Install these tools first:

  • rustup: it installs the Rust version that rust-toolchain.toml pins
  • NASM 2.14 or newer, on an Intel or AMD computer only: the AVIF decoder assembles its x86 code with it. Run brew install nasm, sudo apt-get install nasm, or choco install nasm, and make sure it's on your PATH.
  • Git Bash, on Windows only: it runs the repository's scripts

Clone the repository, install the pinned toolchain with its WebAssembly target, build the plugins that ship with noura, and start the app:

git clone https://github.com/lobbystack/noura.git
cd noura
rustup toolchain install
rustup target add wasm32-wasip2
scripts/build-shipped-plugins.sh
cargo run -p desktop

scripts/build-shipped-plugins.sh builds the Tasks, Projects, Calendar, and AI plugins into apps/desktop/packaging/plugins, and cargo run loads them from there.

Create a workspace, add a note, and open the note's Markdown file in your editor.

Develop noura

Run the checks CI runs from the repository root:

cargo fmt --all --check
cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
cargo test --workspace --locked
cargo deny check

Some plugin tests load the plugins as WebAssembly components and skip themselves when the components are missing. Build them first with crates/plugin-sdk/build-plugins.sh. Follow the contributor guide for the rest of the checks, and the desktop verification guide for the manual workflows.

The TypeScript plugin kit in sdk/typescript uses Node and npm. The marketing website uses Bun. To work on the website, install its packages and start its development server:

bun install
bun run dev:website

Then open http://127.0.0.1:5174 in your browser.

How noura stores your workspace

Your workspace is a folder with a manifest at .noura/workspace.yaml. Notes, tasks, projects, and chats use Markdown with structured metadata in frontmatter. You can move or rename a file without changing its stable identifier.

noura writes workspace files to disk before it reports a change as saved. You can delete its SQLite search index and metadata cache, and noura rebuilds them from those files. The desktop app and the MCP server use the same Rust services:

flowchart LR
    desktop["noura desktop"] --> core["Local core"]
    tools["MCP tools"] --> core
    core <--> files["Workspace files"]
    core --> index["Rebuildable SQLite index"]
Loading

Read the workspace format for file layouts and the local-core architecture for write and recovery behavior.

Repository structure

Start with the directory for the part you want to work on:

Directory Purpose
apps/desktop The desktop binary: windows, menus, drag and drop, packaging, and updates
apps/website Marketing website and legal pages for noura.app
crates/app-core Product behavior and view state, with no UI dependency
crates/app-ui egui screens and the widget kit that draws plugin views
crates/editor-core, crates/editor-egui The Markdown editor's buffer and parsing, and the egui editor that draws it
crates/local-core File operations, validation, indexing, watching, and credentials
crates/workspace-format Parsing, validation, and canonical serialization of workspace files
crates/plugin-host, crates/plugin-sdk The Wasmtime plugin host, and the WIT interfaces with the Rust author library
crates/plugins First-party plugins: AI, calendar, projects, tasks, and a hello sample
crates/mcp-server MCP adapter over the shared services
crates/collab-sandbox, crates/collab-sandbox-guest The sandbox that checks and applies collaborative text edits
crates/sync-protocol, crates/sync-key-envelope Sync wire types, signing, key envelopes, and device formats
crates/sync-server, crates/sync-store, crates/sync-store-sqlite, crates/sync-store-postgres The sync service and its SQLite and PostgreSQL stores
crates/account-web WebAssembly module for passkey sign-in and the encrypted share viewer
crates/spell-check The system spell checker on macOS and Windows
crates/kit-host, crates/live-tests Test drivers for the TypeScript kit and for two desktops syncing
sdk/typescript The TypeScript plugin author kit
docs Workspace format, architecture, plugin, and security documentation
scripts Build, packaging, and check scripts

Documentation

Start with the documentation guide, or use these references for implementation details:

Contributing

Read the contributor guide and the conventions reviewers enforce before changing code. Keep pull requests focused, include tests for behavior changes, and run the development checks.

For workspace-format changes, update the shared conformance fixtures in the same commit.

Support and security

Use GitHub issues for questions, bug reports, and feature requests. For anything else, email hello@noura.app. Follow the security policy to report a vulnerability.

License

noura uses the MIT license. See third-party notices for dependency attributions.

About

The open workspace for humans and AI. Local-first notes, tasks, and projects in ordinary files, with optional end-to-end encrypted sync.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages