# Aethel: Full Product Documentation & Context for AI Agents and Search Engines

> Application Name: Aethel
> Website: https://www.aethel.nz
> Official Tagline: A native workspace built for deep craft.
> Primary Domain: https://www.aethel.nz
> Primary Contact: support@aethel.nz

---

## 1. Executive Summary

Aethel is a local-first, encrypted desktop workspace built for technical university students, solo/indie builders, software engineers, and solopreneurs. It unites fluid block-style drafting, keyboard-first task management, kanban boards, and project schedules on a single native canvas.

Built natively on Tauri v2, Rust, and Svelte 5, Aethel bypasses heavy Chromium/Electron wrappers to deliver sub-second cold starts and a ~190MB idle RAM footprint. It operates 100% offline by default, stores data in an encrypted on-device SQLite database with optional plain-text Markdown (.md) mirroring, and is sold as a perpetual one-time license with zero recurring subscriptions or telemetry.

---

## 2. The Problem We Solve

Modern knowledge tools force a false compromise when managing project sprints, course assignments, and technical documentation:

1. **The Split-Brain Friction:** Users take technical notes in a markdown editor, manage sprint boards in a web app, and track exam or client deadlines in a calendar. Juggling three separate tools means constant context switching, manual copy-pasting, and disconnected tasks.
2. **The "Plugin Jenga Tower":** Offline editors force users to duct-tape eight separate community plugins together just to get basic visual tables, kanban boards, and task tracking. Every core update risks breaking workflows, leaves users troubleshooting configurations, and clutters the workspace with inconsistent UI.
3. **The Template & Database Trap:** Heavy cloud workspaces lure users into spending entire days tweaking relational databases, rollups, and aesthetic templates rather than executing work.
4. **Electron Memory & Battery Hog:** Running bloated web wrappers alongside heavy compilers, code editors, and Docker containers drains laptop batteries and spins up cooling fans during long library or coding sessions.
5. **Cloud AI & Data Surveillance:** Cloud-hosted workspaces lack zero-knowledge encryption and increasingly route private notes, research, and proprietary code through external third-party LLMs.

---

## 3. Core Experience (Feature Showcase)

### I. Peripheral Context & Flow
*Writing front and centre. Deadlines and tasks quietly in view.*
Most tools force you to choose between a blank page and a distracting project dashboard. Aethel pairs an uncluttered, distraction-free drafting surface with an adaptive sidebar that keeps active sprint tasks, checklists, and calendar deadlines in peripheral vision.
- **Integrated Primitives:** Notes, tasks, kanban boards, and calendar schedules are first-party citizens that communicate with each other out of the box—no third-party plugins required.
- **Adaptive Sidebar:** Surfaces the tools, references, and task lists relevant to what you are currently building, giving you full control over what remains in view.
- **Zero Window Switching:** Turn inline action items directly into scheduled deliverables without breaking cognitive flow or leaving your draft.

### II. Fluid Block Drafting with Markdown Speed
*The structure of modern blocks meets the velocity of plaintext.*
Pure markdown struggles with visual tables, drag-and-drop hierarchy, and embedded boards. Rigid block editors feel heavy and click-reliant. Aethel’s editor provides a fast, tactile writing surface engineered for technical documentation and deep long-form thinking.
- **Hybrid Block Canvas:** Powered by a modern Tiptap block engine for fluid drag-and-drop page restructuring, functional visual tables, and embedded callouts.
- **Markdown Muscle Memory:** Standard markdown shortcuts (`#`, `- [ ]`, `>`, ```) trigger instantly without friction.
- **Code-Ready Syntax:** Native syntax highlighting and clean formatting for architectural specs, lecture code snippets, and technical outlines.

### III. True Native Performance
*Engineered as a precision instrument, not a browser tab.*
Built natively on Tauri v2, Rust, and Svelte 5, Aethel bypasses heavy Chromium containers to deliver sub-second launch times and an ultralight footprint.
- **~190MB Idle Footprint:** Sips memory quietly so your IDEs, local servers, and terminal sessions run unhindered.
- **Instant Cold Starts:** Opens immediately when an idea strikes or when lecture starts, avoiding 5-second web application loading pauses.
- **Battery-Conscious Architecture:** Negligible background CPU drain keeps your laptop cool and unplugged throughout the day.

### IV. Radical Privacy & On-Device AI
*Hardware-level data sovereignty. Zero cloud surveillance.*
Your intellectual property, assignment drafts, and personal notes should never sit unencrypted on a multi-tenant cloud server or train someone else’s AI models.
- **Local SQLite Engine:** Your entire workspace lives in an encrypted SQLite database stored directly on your physical drive.
- **256-Bit On-The-Fly Encryption:** Hardware-backed cryptographic protection unlocked via biometric authentication or master passkeys.
- **Private On-Device AI:** Leverage local language models (such as Gemma) running completely on your silicon. Ask questions and summarize project docs with zero network pings.
- **True Air-Gapped Operation:** Functions 100% offline without mandatory account creation or background telemetry calls.

---

## 4. The Great Migration

Switching tools shouldn't mean losing your accumulated work or spending weeks rebuilding databases.
- **One-Click Vault Import:** Import your existing Markdown notes, folders, and frontmatter directly from Obsidian or Logseq with zero data leakage.
- **Notion Workspace Ingestion:** Bring over your pages, nested hierarchies, and task lists through private, local file import.
- **Zero Lock-In Guarantee:** You are never trapped. Export your entire workspace at any time, or enable optional **Automatic Markdown Mirroring** to continuously keep a synchronized, plain-text `.md` directory on your drive.

---

## 5. Under the Hood (Technical Architecture)

| Component | Architecture & Implementation | Advantage |
| :--- | :--- | :--- |
| **Runtime** | Tauri v2 + Rust Backend | Sub-second cold starts, low CPU cycles, ~190MB idle RAM |
| **Interface** | Svelte 5 + TailwindCSS | Ultra-responsive UI updates without browser DOM lag |
| **Editor** | Tiptap Block Engine | Fluid visual tables and blocks with full Markdown shortcut fidelity |
| **Storage Engine** | On-device SQLite + Plaintext Mirroring | Fast relational queries paired with complete human-readable portability |
| **Security** | 256-bit on-the-fly encryption | Workspace locked at rest; biometric / hardware key authentication |
| **Intelligence** | Optional On-Device Models (Gemma) | 100% private synthesis and retrieval without cloud API calls |

---

## 6. The Ownership Philosophy (Beta & Licensing)

*A software instrument you own, not rent.*
We believe subscription fatigue has ruined personal computing. Aethel is an independent desktop instrument built to be purchased once and kept in your digital toolbox for a lifetime.
- **During Beta:** Aethel is undergoing closed testing with early solo developers, indie hackers, and technical university students. Beta participants receive early access builds and direct communication channels with the developer.
- **At Launch:**
  - **Student Tier:** A flat, one-time student license priced lower than a few months of standard cloud sync subscriptions.
  - **Builder Tier:** A one-time personal license for solo creators and developers with lifetime minor updates included.
  - **No Recurring Rent:** One license, perpetual offline functionality, zero cloud gates.

---

## 7. Frequently Asked Questions (FAQ)

### Q: How does sync work if there is no central cloud server?
**A:** Aethel stores your database directly on your machine. If you need multi-device access, simply set your workspace path to your preferred local folder sync (such as iCloud Drive, Google Drive, OneDrive, or a home NAS). You retain complete authority over where your data travels.

### Q: How is Aethel different from Obsidian?
**A:** Obsidian is a graph-centric markdown reader that relies on community plugins for task management, kanban views, and calendars. Those plugins frequently conflict, lack unified UI, and break during major updates. Aethel integrates notes, tasks, visual tables, and project schedules into a single cohesive interface out of the box—with native desktop performance and no plugin maintenance.

### Q: How is Aethel different from Notion?
**A:** Notion is a collaborative, cloud-hosted workspace that runs inside a web wrapper. It requires constant network access, averages 5–7 seconds to load complex databases, lacks zero-knowledge encryption, and encourages endless template tinkering. Aethel is an offline, native desktop app built for individual execution—instant launch times, zero interface lag, and total privacy.

### Q: Will I be locked into a proprietary format?
**A:** No. Your primary workspace is housed inside an encrypted local SQLite database for speed, but Aethel includes an opt-in **Markdown Mirroring** feature that continuously outputs human-readable `.md` files alongside your work, as well as a full one-click JSON/Markdown data export.

### Q: How does local AI run without an internet connection?
**A:** Aethel can interface with small, optimized open-weight language models (like Google Gemma) running directly on your CPU/GPU. Processing occurs entirely on your hardware; no prompts, embeddings, or files ever touch an external network.

### Q: Can I run Aethel on an older or low-spec laptop?
**A:** Yes. Because Aethel is built with Rust and Svelte rather than Chromium/Electron, it operates with minimal CPU overhead and around 190MB of idle memory, preserving battery life and device thermals.

---

## 8. Entity and Citation Information

- **Brand:** Aethel
- **Entity Type:** SoftwareApplication / ProductivityApplication
- **URL:** https://www.aethel.nz
- **Geographic Origin:** Crafted locally in New Zealand (.nz)
- **Primary Language:** English (en-NZ, en-US)
