Repository navigation
Releases
0.12.0
Sixteen changes that make a strategy easier to write, read and act on. The backtests are the same as in 0.11.0.
- Clearer problems. Six messages now say what is wrong, most with a button that corrects it:
crosses over("Change to crosses above"), a parameter outside its range ("Change to 300" or "Change the range to 100..400"), a blank line inside a rule, acsv:path with a space, a date with slashes ("Change to 2015-01-01") and a percentage above its maximum. When two corrections are equally near, both show:samoffers "Change to sma" and "Change to sum". Near the top of the editor, the help opens under the line, so it does not cover the tabs. - Make a number a parameter. Move the pointer to a number such as the 200 in
sma(200)and click "Make 200 a parameter". The plugin addssma_n = 200 in 100..400 step 20, uses it in each place the same call is written, and the block gets a slider. There is also a command, and "Try other values" offers the same for a block with no parameters. - What each figure means. Click a figure's name, such as "Sharpe ratio", to read what it is and how the plugin calculates it.
- Try other values. The tiles say which period their number comes from ("Chosen before 2018-01-01, result from 2018-01-01"). The heatmap's colours show better or worse than the values in the note, not above or below 0.
- Charts by keyboard. Select a chart and use the arrow keys to read it bar by bar, Shift and an arrow for a month (or a year), Home and End, and Escape to go back to the last bar.
- Copy. "Copy as Markdown" in the menu puts the result on the clipboard, ready to paste into a note. The panel of the status line has "Copy" for the order alone.
- Old prices. When the prices of a result are old, the status line says so in amber ("Prices end on 2026-11-05. They can be old. Click to load new prices."), and a folded result shows "Old prices".
- When a backtest does not run. The card gives the next step: "Change to BRK-B" for a ticker that the source does not know, "Open settings" for an API key, "Use a CSV file" for a file that is not there. Today's orders and the
backteststable have the same buttons. - Loading. The card counts the tickers ("Prices: 3 of 7.") and names one that is slow. CSV files are read in the background, so a large file does not stop Obsidian (a 62 MB file: about 0.09 s of the window's time, not 0.9 s). A file over 100 MB is refused with its size.
- Go to the block. A strategy clicked in Today's orders, the
backteststable or a forward test opens its note at that block, with the result open. - New strategy note. A new command, also with no note open: select a starter strategy and the plugin makes a note for it. Empty windows have the same button.
- Today's orders in the sidebar. "Keep in the sidebar" (or the command) keeps the list open while you work. It shows the time of the last check and uses the status bar's check, so the prices load once.
- Commands for a note. "Refresh all strategies in this note", "Fold all results in this note" and "Open all results in this note", and for the strategy at the cursor: refresh, keep as a note, start a forward test. You can give each one a hotkey.
- Rename a strategy. "Rename the strategy at the cursor" changes the name and keeps the record of tries (so "Was it luck?" still counts them) and the links to it in
compare,accountand forward-test notes. If you change the name line yourself, the result offers the same move. - Command line and MCP server.
checkshows the corrections,check --jsonandcheck_strategygive each one as an edit, andcheck --fixwrites the ones that have no alternative.explainreads phrases such asfor 3 bars.
0.11.0
A new design for every surface of the plugin. The figures and the backtests are the same as in 0.10.0.
- The top of a result. One line under the title says what the strategy holds and how near its next order is: "Long SPY since 2026-04-09 · +8.6%" and "Sells unless it closes above 730.27 · 0.01% away", in amber within 2% of the last close. Click it for a chart of the last 30 closes against the price of the order. It replaces the chips and the "At the next close" panel. The save buttons, "Start a forward test" and "Save this note's results to its properties" are in a menu (three dots) at the right of the title.
- Figures. Each figure has a mark that shows who did better, and the head counts them: "Better on 3 · worse on 2". Move the pointer on a figure to see where it comes from on the chart.
- Chart. The read-out keeps its place, the spans (All, 10Y, 5Y, 1Y) move the chart to the new span, and the largest gap between the lines is named ("Buy & hold ahead").
- Tuning. Drag a number in the rules to change a parameter, or use its slider. While you drag, the run as written stays on the chart as a dashed line, each figure says how far it moved, and the tabs wait until you let go. After "Try other values", the sliders show the return per year of each value on their tracks.
- Tabs and tools. Trades, Years, Months and Regimes are tabs with a line of what is in them. The other sections are round buttons under "Test the idea".
- Folded results are on fixed columns, with a small chart, so a stack of folded blocks reads as one list.
- Problems. A block that cannot run shows its own lines, the problem under the line that has it, and a button that writes the correction into the note ("Change to sma"). The orders window and the
backteststable have the same button. - Today's orders. A row for each order, close to watch and problem, with a tag of what to do. A close to watch has a bar that fills as the close comes nearer. Holdings are folded.
backteststable. Six columns with a small chart, rows that move to their place when they finish or when you sort, and a narrow layout.- Editor. Over an indicator in a rule, the help also shows its value at the last close on the block's ticker, from the saved prices.
- Motion. A result arrives once, the first time it shows in a session, and folding, tabs and panels ease open and closed. With "Reduce motion" on in your system's settings, every change happens at once.
- Contrast. All text has a contrast of 4.5:1 or more with its background, in Obsidian's default light and dark themes. The rules keep your theme's code colours, mixed with the text colour where necessary.
0.10.0
All text that the plugin shows is now in Simplified Technical English (ASD-STE100): short sentences, one meaning for each word, and no contractions. Trading terms stay. The figures and the backtests are the same as in 0.9.2.
- Results. The verdict now reads "7.2% a year, compared with 10.6% for buy and hold. But its worst drawdown was smaller: 24%, compared with 55%." The result uses "worst drawdown" in all places, and "better than" or "worse than" to compare with the benchmark.
- Messages. Errors, warnings, quick fixes, editor help, explanations, luck checks, the sweep, orders, accounts, forward tests, the command line and the MCP server use the same plain style.
- New names.
- Settings: "Start capital", "Price source for tickers without a prefix", "Use Tiingo when Yahoo is not available", "Result view", "Find orders when Obsidian starts", "Find tickers while you type".
- Commands: "Write a strategy from a description", "Delete saved prices", "Correct the problem at the cursor". The command IDs did not change, thus your hotkeys continue to work.
- "Market falls" is now "Market drawdowns". The trade button is "Show the reasons for this trade".
- Forward tests. A new forward test writes a different comment above its pinned settings. Thus its check code is different. Forward tests that you started before are not affected.
- The prompt that the plugin sends to a language model did not change.
0.9.2
Fixes the two problems Obsidian's Community plugins review found in 0.9.1. The plugin works as before.
- The settings tab no longer reads a value through a part of Obsidian's API that is newer than the oldest Obsidian version the plugin supports.
- The editor's help tooltip no longer sets a style directly.
0.9.1
Ready for Obsidian's Community plugins directory. The plugin works as in 0.9.0.
- iPhone and iPad. On iOS before 16.4 the plugin could not load: five patterns it uses to read text needed a feature those versions lack. They are rewritten, and a test now stops the feature from coming back.
- Styles. Two labels that were placed with inline styles now use the stylesheet.
- README. It now shows screenshots and is rewritten in plain language.
0.9.0
The language for models and tools. The plugin works as in 0.8.0; what is new is everything around it that lets an AI assistant write, check and run strategies.
- A guide any model can read.
llms.txtandllms-full.txtin the repository give a model the whole language: what a block is, every setting, rule and value, what not to do, worked examples and how to check a block. They carry the same text the drafting command sends, made from the plugin's code, so they list exactly what the parser takes. - Worked examples and mistakes.
docs/corpus/holds requests in plain English with the blocks that answer them, using every word of the language, and blocks with a common mistake, the parser's exact messages and the fix. Every block is checked by the tests. - A word list and grammars.
docs/language.jsonhas every function, setting, value and word with its form, meaning and example.docs/grammar/has the text of a block as a Lark grammar (OpenAI's grammar-constrained tools, vLLM, llguidance) and a GBNF grammar (llama.cpp), for models that generate under a grammar. - A command line and MCP server.
backtest-blocks.mjs, attached to this release, runs with Node.js 20 or later.checkchecks the strategy blocks of a note and prints each problem with its line,runbacktests a block on live prices,explainsays what a word means, andmcpserves the same as tools for Claude Code, Claude Desktop, Codex or any MCP client, with the guide, examples and grammars as resources and awrite_strategyprompt. - Tried from a terminal and over MCP with live prices; its figures match the plugin's for the same block.
0.8.0
More to say in a rule. Every block that ran in 0.7.0 gives the same result in 0.8.0.
- Definitions.
uptrend = close > sma(200)names a condition or a number. Use the name in rules, in a ranking score and in other definitions, as inbuy when uptrend and rsi(2) < 10;uptrend of SPYanduptrend[1]read it for another ticker or a bar back. The rule table opens a definition into its parts, and hovering over its name shows what it stands for. - Conditions that last.
close > sma(50) for 3 barsholds on each of the last 3 bars,rsi(2) < 10 within 5 barson any of them, andcount(close > close[1], 10)counts the bars it held.rsi(2) between 10 and 30sets a range, andcrossesalone means either way. - Rules for a few tickers at once.
for SPY, QQQ:gives the rules and stops under it to each ticker listed. - Exits that follow the position.
highest since entry,lowest since entryandposition returnmake a chandelier exit or a profit target, as insell when close < highest since entry - 3 * atr(22). - New functions.
sum,dema,tema,kama,aroon_up,aroon_down,psar,cmf,linreg,rsquared,efficiencyandstreak, withsqrt,log,expandif(condition, a, b)for scores such as Clenow's momentum. - Calendar.
trading_dayandtrading_days_leftcount the trading days of the month, for turn-of-the-month rules, andquarter,week_start,week_end,quarter_start,quarter_end,year_startandyear_endmark the edges of each period. - A block that already used one of the new words as a parameter name, such as
count = 20, keeps working: the name means its parameter there. - Tried in a running Obsidian on live prices, with exits, levels and calendar dates checked by hand.
0.7.0
A new way to read a result. The figures are the same as in 0.6.0; what changed is how they are drawn.
- A verdict first. A sentence sets return per year and worst fall against buy and hold ("7.2% a year against 10.6% for buy and hold — but its worst fall was 24%, not 55%."), and a second one compares the Sharpe ratios, the time in the market and the years it was ahead. The wording is fixed and filled in with the run's figures.
- Figures side by side. Each figure is a row with the strategy's value, the benchmark's, a dot for each and the difference. "More figures" adds the Sortino ratio, best and worst year and month, months with a gain and the longest time below a high.
- A chart you can read. The gap between the two lines is shaded in the colour of whichever is ahead, the market's big falls are shaded and named, and a strip shows the time held (hatched where short). Move across it and the line above reads that bar: date, values, how far below the high, what was held and which fall it lies in. All, 10Y, 5Y and 1Y show a shorter span.
- At the next close. What it holds now, the next order in a sentence, and a scale of the closes that would give it, with the last close marked. A mark by the title says when an order is within 2% ("0.33% from a sell").
- Sections as tabs. Trades, Years, Months and Regimes and crises open one at a time, each with a line of what is in it: every trade's return as a bar (click one to find it in the list), the gap to buy and hold each year, a calendar of monthly returns, and the market falls as rows on one scale.
- Shorter block text and folded line. The block's settings fold away behind "Show the whole block", since the line under the title says them in words. A folded result shows a small chart of its value.
- Tried in a running Obsidian, light and dark, at desktop, preview-panel and phone width, with long, short, leveraged, ranked, weekly and hourly blocks.
0.6.0
Short selling and leverage: a strategy can now go short, flip between long and short, and hold up to twice its equity, with a borrow fee, interest on borrowed money and margin calls. Results of existing strategies do not change: a block with no short rule and weights within 100% runs exactly as before.
- Going short.
short whenandcover whenrules sit besidebuyandsell. A block can trade one side or both; with only a buy rule and a short rule, a ticker flips from long to short on the same signal, as in the new starter "Trend, long or short". A short's stop sits above its entry and its target below, and a trailing stop follows the lowest price. Each short pays a borrow fee for every day it is held, 0.5% a year unless aborrow feeline or the new setting says otherwise. - Leverage up to 2×. Weights and
sizecan add up to 200%. Money borrowed pays interest, 6% a year unless amargin rateline or the new setting says otherwise. When equity falls below 25% of the positions' value at a close, a margin call closes everything at the next open; a run that loses all its equity ends there. - Results. For a block that shorts or borrows, the "Time invested" tile becomes "Exposure", gross with net beside it, and the result notes the borrow fees, the margin interest and any margin calls. Trades get a Side column, the price chart marks short sales and covers and shades the time held short, and "Explain this trade", the bar-by-bar table, the folded line, the dashboard, the trades CSV and note properties all say which side.
- Orders and accounts. Today's orders, trigger prices and forward tests say "Sell short" and "Buy to cover", with a flip as its two orders. An
accountblock can hold shorts (SPY -50) and cash below 0 when a strategy it follows can borrow, and gives "Flip" orders. Broker files read short sales and buys to cover, such as Schwab's "Sell Short" and "Buy to Cover" rows, as trades. - Checks. Luck checks keep each trade's side, regimes and crises show gross and net, and the cross-check against a second backtester gains eight short and margin cases, 44 in all.
- Not yet. A ranking (
hold: top 3 by …) can't also go short; a block with both says so. Hard-to-borrow lists, per-stock borrow rates and short-sale restrictions are not modelled.
0.5.0
From backtest to trading: what to watch at the next close, a forward test of frozen rules, your brokerage account against your strategies, a count of the tries behind a result, and two more sources of data. Results of existing strategies do not change.
- Trigger prices. A "Next close" column under Positions says at what close of the next bar each ticker's rules give an order: "Buys if it closes above 512.30 (+1.2%), at the following open", with the stop and target of a ticker held. The orders window and the saved orders note gain "Watch at the next close", and the status bar's tooltip names the nearest ones.
- Forward tests. "Start a forward test" freezes the rules, the settings they ran with and the day, in a note of its own with a
forwardblock. It measures only the bars after that day, against the benchmark and against earlier stretches of the same length, says when the rules or the start were edited, and keeps a log of the bars that gave orders. - Accounts. An
accountblock holds what an account owns, its cash and the strategies it follows with their shares, and gives the orders that bring it to what they hold together, netted across strategies, in whole shares if you like. "How to split" suggests weights (equal, inverse volatility, minimum variance, maximum diversification), worked out each month from earlier months only, also under acompareblock with weights. Given a file of your trades from Schwab, Fidelity or Interactive Brokers, or any CSV whose columns you name, it compares your fills with the strategies' trades: slippage, fees, late and skipped trades, and what not following the rules cost. - Was it luck? Each block counts its tries, the runs and slider values and sweep variants it was shown, and the deflated Sharpe ratio says how likely the best of them is to have real skill. A sweep gains the probability of backtest overfitting. A Versions section lists each version of a block's text that ran, with its figures, the lines that changed, and a button to restore it.
- Regimes and crises. A section that, once you load SPY, ^VIX and ^TNX (or BTCUSDT), splits a run by the market's trend, volatility and rates, and shows how it did through each crash it covers, from 2000 to 2025.
- FRED and Tiingo.
fred:T10Y2Yreads an economic series as each value was first published, as a rule's input or as the cash rate (cash rate: fred:DGS3MO).tiingo:SPYordata: tiingoreads Tiingo's prices, and "When Yahoo fails, use Tiingo" stands in for Yahoo. Both need a free API key, kept in Obsidian's secret storage. - Faster sweeps: a 2,000-variant sweep took 4.9 s in Obsidian, against 9.3 to 10.5 s on 0.4.2, with the same results.