Emrald

by Devon
5
4
3
2
1
Score: 52/100

Description

Obsidian plugin for Effort Management — track what your work actually costs you.

Reviews

No reviews yet.

Stats

4
stars
351
downloads
0
forks
103
days
1
days
1
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
116
commits

Latest Version

a day ago

Changelog

EMRALD 1.4.4

Change a profile answer in place, and see your Verification share from Qarett.

Improvements:

  • Click any answer on Effort Profile to change just that one. Your current answer is marked, and only the answer you change is saved. When your recent sessions point a different way, a short note says which.
  • Data Center has a new From Qarett section with Verification share: how much of each work session went to checking work rather than producing it. It lists each answer with its date and project, plots them, and shows your 30-day average as a dashed line. It's free on every plan.
  • The profile questions match the web app. The five-point scales read Disagree to Agree or Rarely to Often, the chronotype list adds Very early (3–5am), and Late night now covers 10pm–2am.
  • Small wording fixes in setup and in the profile screens.

minAppVersion stays at 1.13.0.

README file from

Github

EMRALD for Obsidian

Track what work costs you, beyond what you finish.

EMRALD for Obsidian

EMRALD is an effort management plugin for Obsidian. It helps you track patterns around effort, flow, energy, recovery, and burnout risk without leaving the notes and projects you already rely on.

Most productivity tools can tell you what got done. EMRALD is built to help you understand what the work actually cost you.


Why EMRALD exists

A task list can say you're doing fine while your actual capacity says otherwise.

EMRALD was built for that gap.

Instead of forcing you into a brand-new productivity system, it adds an effort-aware layer to Obsidian so you can keep the workflow you already trust and gain a clearer picture of how your work affects you over time.

Keep your stuff. EMRALD adds the effort layer.


What it does

  • Track focused work sessions from inside Obsidian
  • Capture quick post-session effort receipts
  • Record daily check-ins around energy and readiness
  • Monitor patterns in effort, flow, and recovery over time
  • Surface burnout-related signals before they become obvious
  • Keep project and effort awareness close to your notes
  • Work alongside your vault instead of replacing it

Who it's for

EMRALD is especially useful if you:

  • already manage work or life systems inside Obsidian
  • want more than time tracking or task completion
  • regularly feel "productive" but still end the day cooked
  • care about sustainable output over maximum output
  • want your system to reflect real capacity, not fantasy capacity

Screenshots

The sidebar: your daily workspace

Timeblock timer, projects, and effort tools, always one click away.

Timeblock (active session) Projects
Timer running Projects

The workspace views: your patterns over time

Effort Allocations: see how your day breaks down across effort levels. Effort Allocations

Effort Profile: your capacity, endurance, and motivation at a glance. Effort Profile

Burnout Monitor: watches for sustained effort, before patterns get obvious. Burnout Monitor

Screenshots show dark mode. EMRALD adapts to your active Obsidian theme.

See it in action

A full session flow: Start → work → Stop → Effort Receipt:

EMRALD demo


Getting started

  1. Create an account at app.effortmastery.com
  2. Sign in and generate your API key
  3. Install the EMRALD plugin in Obsidian
  4. Open EMRALD settings and paste in your API key (once per device; Obsidian keeps it in its keychain)
  5. Start your first session

If this is your first time using EMRALD, expect the value to build over time. The first few sessions give you a starting point. Keep filling in your receipts for a month and the full picture is yours.


What's new

Change an answer, and see your Verification share from Qarett (1.4.4). Click any answer on Effort Profile to change just that one. Your current answer is marked, and only the answer you change is saved. Data Center has a new From Qarett section with Verification share, how much of each work session went to checking work rather than producing it. It lists each answer with its date and project, plots them, and shows your 30-day average as a dashed line. It's free on every plan. The profile questions now match the web app: five-point scales read Disagree to Agree or Rarely to Often. The chronotype list adds Very early (3–5am), and Late night now covers 10pm–2am.

A shorter first run (1.4.3). Setup is now Connect, Welcome, your first project, then Ready: pick your hours a day and your first session starts. The profile questions are no longer part of setup. Open them any time from Effort Profile or the command "Fill in your profile". Nothing is pre-answered, five-point buttons replace the sliders, and a question you skip stays blank. The six work types have plain names, like Big-picture ideas and Finishing things. The first-receipt welcome appears once per account, in any vault.

Plainer words throughout (1.4.2). The plugin now reads the same as the web app, in everyday words instead of jargon. Digests are recaps, the E-Level Overview is Effort Allocations, "Calibration" is "Guesses" and "Drift from your profile", and the Burnout Monitor says "Not enough data yet" instead of "All Clear" when there is no score to judge from.

Your recap time, in your time zone. Pick the day and hour of your weekly recap in your own local time. The plugin reads your saved schedule when it starts, so a change made on the web stays changed.

Check-ins this week. The sidebar counts your check-ins over the last seven days in place of a streak.

Receipt graph. In Effort Allocations, each project row has a graph button. It opens that project's receipts as a line of dots, right under the row. Pick one receipt value (how hard, right amount of effort, how enjoyable, flow state, any complications, and the verification share on Qarett receipts), filter by 7, 14, 30 or 60 days, and click a dot to read that session: date, length, ratings, work type and the one-line summary. Free for everyone.

Per-project questions. Tell EMRALD what a project will cost you before you start. Complexity, how familiar the work is, whether it's the kind of thing you get pulled into. Once you've logged sessions, EMRALD shows your forecast next to what actually happened, side by side. It never blends the two into a fake composite score.

Effort forecasting. For multi-day projects, EMRALD can suggest a starting effort level and field hints. Drawn from how similar past projects actually went for you. If there isn't enough history yet, it tells you that plainly.

Area grouping. Tag projects by area (Work, Health, Family, or whatever fits your life) and see across your workspace.

Extra insights (PRO). Phrasing varies instead of repeating the same sentence, and it adds two categories: Discovery (patterns in your own data) and expanded Warnings (early heads-ups on sleep and effort volatility). Burnout warnings are identical on every plan.

Templater & Periodic Notes integration

EMRALD automatically writes a daily summary file to your vault at .emrald/daily-summary.md. This file updates every time you stop a session, complete a check-in, or close your day.

If you use Templater and Periodic Notes, you can pull this data into your daily notes automatically.

Setup (3 steps)

  1. Install Templater from the Obsidian community plugins, if you haven't already.

  2. Add this line to your daily note template wherever you want the summary to appear:

    <%- await app.vault.adapter.read(".emrald/daily-summary.md") %>
    

    Why adapter.read()? Obsidian's vault index doesn't see dotfile paths (.emrald/), so the standard tp.file.include() can't resolve them. This reads the file directly from disk.

  3. That's it. The next time Periodic Notes creates a daily note (or you manually create one from your template), your EMRALD data fills in automatically.

What the summary includes

  • Session count and total hours for the day
  • Project breakdown: which projects you worked on, how long, what effort level, how many sessions
  • Check-in scores: energy, focus, stress, sleep quality, mental clarity
  • Burnout risk level: Low / Moderate / High / Critical with score

Example output

## Today's Effort
- **Sessions:** 3 | **Total:** 4h 12m
- **Check-in:** Energy 4/5 | Focus 4/5 | Stress 2/5 | Sleep 7/10 | Clarity 8/10
- **Burnout Risk:** Low (18/100)

## Project Breakdown
- **EMRALD MVP** (E3): 2h 48m ×2
- **Marketing** (E2): 1h 24m ×1

Notes

  • The .emrald folder is created automatically the first time EMRALD writes the summary.
  • A README.md inside .emrald/ has setup instructions and use case ideas. It’s created once and never overwritten.
  • The file updates in place. It always reflects today's data, not historical.
  • If you don't use Templater, you can still open .emrald/daily-summary.md directly. It's a plain markdown file on disk.

Suggested uses

The summary gives you the raw data. Your daily note is where you add the meaning.

Pair it with a Reflections section in your daily note template:

<%- await app.vault.adapter.read(".emrald/daily-summary.md") %>

## Reflections
- What did the numbers miss? How did the day *feel*?
- Did I work on what I planned, or did something pull me away?
- What would I do differently tomorrow?

Track patterns over time:

  • Compare your check-in scores with how the day actually went
  • Notice when high-stress days cluster. That’s a burnout signal your task list won’t show
  • Catch effort drift: spending hours on the wrong project without realizing it

Use it as an accountability mirror:

  • "I planned to focus on Project X but spent 80% of my effort on Project Y"
  • "Burnout risk has been Moderate three days straight, time to ease off"
  • "My clarity was 9/10 and I wasted it on admin tasks"

Companion theme

The optional EMRALD Theme is the official companion theme for the plugin. It is built to match the workspace visually, but it is completely optional and can stand on its own.


Privacy and data

EMRALD connects to the Effort Mastery API (api.effortmastery.com) to sync session data, metrics, and insights. This is how the plugin works: there is no local-only mode.

What EMRALD sends:

  • Session data (start/stop times, effort level, project association)
  • Effort receipts (your ratings, plus any short note you type)
  • Daily check-in responses (energy, readiness, plus any short note you type)
  • Project details (name, effort level, status, area, and the path of a linked note)
  • Profile answers (only the questions you choose to answer, and any answer you change later)

What EMRALD never sends:

  • Note content: EMRALD does not read, upload, or modify the body of your vault notes
  • File contents, attachments, or images
  • Vault structure beyond the folders you designate as Active/Inactive during onboarding and the note path you choose for a linked project

Vault access:

  • EMRALD lists your vault's markdown files so you can pick a note to link to a project (in onboarding and from the sidebar) and to find a project's note again when its path has changed. It reads no note content.
  • processFrontMatter writes metadata (effort-level, session info) to note YAML, never note content
  • No background vault scanning occurs outside of the folder sync you configure

External domains:

  • api.effortmastery.com: API (session sync, metrics, insights, authentication)
  • app.effortmastery.com: linked from settings for account management
  • getemrald.com: linked from the About view for documentation

No data is shared with third parties. No analytics or tracking SDKs are included. Full privacy policy: effortmastery.com/privacy


Development

npm install
npm run dev

Build

npm run build

License

MIT, Effort Mastery LLC