Releases: jgsw/ipsissima
Release list
Ipsissima v0.2.7
Changes
- Your Zotero, both ways, in the desktop application: the Manuscript header's Zotero highlights button shows your own highlights, underlines and notes from Zotero running on this computer, painted on the very words you marked in your own Zotero colours — the marks stay Zotero's, never copied; select a passage and Highlight in Zotero creates a mark in Zotero itself, on the PDF, at the exact rectangles where those words are printed (the converter now writes a small geometry file beside every conversion for this); and File ▸ Store in Zotero… stores the reconstruction under its source's Zotero item as one bundled attachment carrying the text inside it, refreshed in place and never duplicated. Zotero asks your consent in its own dialog, once, by name; nothing leaves your machine. Ipsissima-MCP's
zotero_storetool drives the same machinery from Claude. - Study mode, on the map's bar and under How to use: the map asks what you think holds each claim up before it unfolds it, and never types, scores or records — the pause is the whole apparatus. The guided mode now hands off to it, so the builder becomes their own map's first reader; the Layout menu's "Study" is renamed "Follow" so one word keeps one promise.
- Comparing two readings of the same text: choose the other
.argdown(File ▸ Compare with Another Reading… in the application; the glyph at the right of the Manuscript header on the web page) and each passage's margin says whether both maps read it, only this one, or only the other — with a ⚑ where the two read the same words differently: a crux declared on one side only, a disagreement about who is speaking, or the checked end of the fidelity ladder against the interpretive end. Nothing is judged;compare_argdown.pyreports the same from the command line. - The map declares its own provenance beside the title, the way it already declared the text's: "machine-written map" where the front matter says
reconstruction: generatedwith no recorded pass, "map read by a person" wherereviewed:records one — a declaration, never a certification — and "one reading · N cruxes" where the map tags#crux, the new convention by which a reconstruction names the points where the text underdetermines the reading and which road it took. - The Manuscript pane reads as the article: a Contents list floats the file's own headings over the text, each with its printed page and the section under your eyes marked as you scroll; the orientation panel carries a source's
voice:declaration ahead of its abstract, for a text whose value is not its argument (the Modest Proposal question); shift-clicking a passage reframes the map on the claims it lit, zooming out as far as it needs; and selecting words offers Quote and Paraphrase only where you are writing the map — a map built by hand, or a machine-written one you have edited — and Highlight in Zotero only where the text came from Zotero, so the two workflows stop sharing one row. - Conversion, measured on real papers and repaired where it fell short: one PDF route (the structured converter first, the plain extraction a loud fallback); publisher apparatus — running heads, footers, copyright blocks, access stamps — cut at creation and counted in the file's own header; paragraphs that end where the author ended them, from each page's own margins; displayed quotations as blockquotes, bibliographies one entry per line, footnotes lifted to
[^n]:definitions with their numbers rejoined, abstracts recovered into the front matter, ligatures expanded, thezotero:attachment key written from the storage path; saved web pages found by text density with embedded images stubbed, and a Project Gutenberg header and licence dropped together. - Ipsissima-MCP: the three tools a model scans for are renamed so the trigger word is in their names —
argdown_plan,argdown_method,argdown_check— because a deferred-tool client forwards names and little else;argdown_checkreturnschecked_file(md5, bytes, mtime) so the file written and the file checked cannot silently differ, and no longer crowns an intermediate conclusion as the apex; the extraction prompt and digest teach the crux convention; the strength table gives "ordinary" the standing objection the other two already carried. - Repairs from first use: a highlight written to Zotero was refused ("annotationType must be set before other annotation properties") because the fields were sent in alphabetical order — fixed, and held by a unit test; the map's control bar no longer spills under the manuscript on a narrow map pane, its hashtags wrapping instead; Zotero 10's local API is asked for annotations by type, since a bare children request answers without them.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Five finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; four more are in samples/ — or download the samples zip below, which carries all nine with their source texts, ready to drop onto the app or the page as folders.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.6
Changes
- The Will to Believe's thesis claim is titled in prose — "Passional nature must decide genuine options" — so the essay's famous claim announces itself on the map instead of hiding behind a box labelled "Thesis", below the closing corollary the layout must put on top.
- The website describes the map as what it is: the classic defence of the legitimacy of religious faith, against Clifford's rule that believing on insufficient evidence is always wrong.
- The samples now ship with every release as ipsissima-samples-.zip — all nine worked reconstructions with their source texts, folders intact, ready to drop onto the app or the pages.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Five finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; four more are in samples/ — or download the samples zip below, which carries all nine with their source texts, ready to drop onto the app or the page as folders.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.5
Changes
- Two worked reconstructions join the samples, both generated end to end by a model driving Ipsissima-MCP and verified by the checker: William James's "The Will to Believe" (also on the website's worked examples) and Swift's "A Modest Proposal" — the dramatised-text test case, whose README says how to read it.
- A privacy repair in PDF extraction: JSTOR-style access stamps embed control characters that defeated the blanking patterns, so the downloading institution's IP could survive in a shareable file while the notes reported stamps removed. Control characters are now stripped first, the identity lines actually blank, and an audit names any line that still looks like a stamp.
- The bronze route reports what it used to miss: page-edge truncation (characters missing with nothing garbled), a second article interleaved on a scanned sheet, and that a PDF's p.N markers count sheets rather than printed folios. Project Gutenberg page anchors become real page markers instead of splitting sentences mid-quotation, and single and double quotation marks now fold together in verification.
- Declared contentions: a paper that argues thesis → application → closing corollary can name its stated theses in the front matter (
contentions:), additively to the computed apex, so the map opens on the thesis rather than the coda. Checked, honoured by the checker and the viewer's spine, load and depth ladder alike. - check_reconstruction returns
shape— the census as data (apex, contentions, contribution, fidelity, quotations, interpretive load) — assembled from the same objects the prose is printed from. page_images returns crops under 200 KB inside the result as images, so a client on another machine reads the page directly. - The reconstruction method hardened by use: the dramatised-text policy (persona #reported, voice-breaks noted, contentions imputed), inline quotation as house style, refutations wired so the census cannot crown the demolished target, and a generated map may no longer stamp itself reviewed.
- argdown-pandoc: the App's maps in anyone's Pandoc — LaTeX figures, slide-aware scaling, pptx export carrying a PNG map, and the explode staircase available outside the template.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Five finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; four more are in samples/ — or download the samples zip below, which carries all nine with their source texts, ready to drop onto the app or the page as folders.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.4
Changes
- Ipsissima-MCP now serves its reconstruction method through the one channel every MCP client has: the new
reconstruction_methodtool returns the full instructions and reference documents as ordinary tool results, andextract_text's reply carries a compact conventions digest — so a client that can only call tools (Claude Cowork among them) gets the whole method instead of guessing at Argdown. - The checker names what it used to carry silently: a metadata key nothing reads gets a did-you-mean; an undercut aimed at a statement is a fault with a line number, because the parser quietly reattaches such arrows to an inference elsewhere in the file; a generated map stamped
reviewed:is asked who reviewed it; duplicate quotation-context findings are gone; and a cut sentence's whole continuation is shown, so it can be fixed in one round rather than one clause per round. - Word counts for .epub, .docx and .odt sources are counts of the text, not of zip bytes read as prose — a 6,500-word pamphlet no longer plans as an 11,000-word job.
- Dramatised texts — a satire, a dialogue, a thought experiment — have a stated reconstruction policy: the persona's case tagged #reported, the voice-break asides untagged with a note carrying the attribution, the author's real contentions imputed at the apex. And an imputed contention now counts in its own interpretive load, so a map of a text that never states its conclusion says so in its numbers.
- The mission line — "Making complex reasoning intelligible through maps you can check at every step" — now stands everywhere the old subtitle did, the site's footer and metadata included.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.3
Changes
- Pinch-to-zoom now works on the map: the content under your fingers stays under them — spreading zooms about them, moving both together pans — in the app and in both HTML pages, on Android and any other touch screen; a finger left down after a pinch goes on panning and never reads as the click that clears your selection.
- A phone's screen belongs to the map: at phone widths the status footer stands down — its counts, the borders state and the exposition verdict all remain under How to use, in the statistics — and the map's control bar folds to a small CONTROLS chip on any screen, a standing choice the page remembers until the chip unfolds it.
- A reconstruction that cites no manuscript now exports: the self-contained web page export asks only for a drawn map, the bundle entry says what it lacks and the remedy — open the folder, or a bundle — rather than vanishing, and File ▸ Export says why when there is truly nothing to export instead of silently doing nothing.
- Export from the map itself: the right-click menu carries an Export… entry beside Show the key, so the browser page — where the Export button lives in a Notes pane that a map without marks never shows — can always reach it, and the menu opens where you clicked.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.2
Changes
- The key: a small card of the map's markings — borders, lines, chips and the sparkline, drawn with the real strokes, this map's usage bright and the rest dimmed — offers itself once over a corner of the map, folds to its header and stays across maps if you want it, and is always available from Help ▸ Show the Key, the map's right-click menu, and How to use ▸ The key.
- Quotation borders are now checked against the manuscript everywhere you ordinarily read — a folder opened in the application, a folder dropped on the page, a bundle — not only in built samples; the status line says which state you have and how many borders were corrected.
- Exposition speaks neutrally about where the reasons fall — support anticipated, support prepared, still to come, already given — every section header's hover now carries its reading in words, and neither way of writing is graded.
- A step that names a textbook rule is now asked whether it really is that rule: a valid modus ponens labelled Modus tollens comes back flagged by the checker, and every verdict drawn on the map attributes itself to the formalizations given.
- The samples now say, checkably, which of their steps claim deduction: Carroll's Euclid step and Achilles's demand are formalized and checked — with C and D reported as premises the step does not need, which is the dialogue's own moral arrived at mechanically — Akhlaghi's refutation of the interest and utility views runs hypothetical syllogism into modus tollens, Miller's eight formalizations are stamped, and the other four samples verifiably claim no deduction at all.
- The Manuscript tab teaches instead of hiding: a map that cites a manuscript this viewer has no copy of shows the tab disabled with the remedy attached — drop the folder rather than the file.
- The no-network promise is asserted at runtime by the test suite — a driven session of every built viewer must make no request that leaves file: — alongside a new promises lint that holds the licence boundary, the CI's honesty rules, every sample's licence note, and the pairing of menu items with the page's own controls.
- Ipsissima-MCP: the install probe sentence now tells the truth per machine (10 tools, 9 without a Zotero library), check_for_updates is documented as the bundle's only update signal, and the EPUB and book-splitting routes are tested end to end on a real book.
- The project's values are written down: docs/values holds the principles with their provenance and weight as case law, the tensions found when the code was audited against them, and an analysis of what a machine may — and may never — say about whether a change is an improvement.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.1
Changes
- The hashtag row gains an untagged switch at its end. Until now an untagged claim passed whatever was switched off, which is why the filter seemed to do so little: the Miller map is 22 tagged claims out of 66, so switching every hashtag off still left two thirds of the map exactly where it was. Switch untagged off and what remains is the claims that carry a tag — the authorities on their own, or the reported views on their own.
- The contention stays on screen when untagged is off, as it does under the spine filter, so a map is never left with nothing at its head.
- Hiding the untagged claims brings buried tagged ones into view: shorter chains and unstranded components let the map show tagged claims that were previously below the depth limit — nine of them on the Akhlaghi map.
- A claim its author did not name now shows its sentence rather than the parser's placeholder for it, both in the compact view of an exploded argument and as a box on the map, where a heading reading "Untitled 2" stood over the sentence it was standing for.
- Switching every hashtag off and untagged off leaves the map empty, and the controls now say so: previously the bar kept whatever it last showed, so a blank map appeared under a lit chip and read as a fault rather than as a total filter.
- The rendered-map harness now drives the hashtag filter, which nothing had ever exercised, and can be pointed at any corpus of Argdown files rather than only the published samples.
- A rule name is a label, and How to use now says so: it lists the eighteen names the map abbreviates, says any other name is accepted and drawn as written, and says plainly that the name is never what gets checked — the verdict comes from the
formalizationlines alone, so a step labelled with the wrong rule passes quietly. The extraction prompt carries the same list. - A formula can now record the words it was written for —
{formalization: "u -> na", formalized: "3d2a90f1"}. Edit the claim afterwards and the map stops calling the step checked, drawing the rule name with a wavy underline instead, because a formula that no longer matches its sentence has not checked anything.check_argdown.py --stampwrites them; it records your agreement rather than establishing it, since nothing can tell whether a formula fairly renders an English sentence.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.2.0
Changes
- A premise-conclusion step may name the rule it relies on, and Ipsissima now checks it: give the claims a
formalizationand the bar says whether the conclusion follows, quietly when it does, with a red badge and a countermodel when it does not, and hollow where a rule is named but nothing has examined it. - Formalising the four steps of The route to the order in the Miller judgment returned a countermodel on the first one, which is a premise the Supreme Court applies and never states; it is now in the map as an imputation, warranted as an enthymeme.
- A multi-step argument carries a ⊞ control that opens it as a staircase — one small argument per step, each intermediate conclusion in a box between them — in full text, or drawn compactly from the claims' short names so the whole shape fits on a screen; either can be saved as SVG or PNG.
- A numbered premise takes you to the claim it names and offers a way back, which can now be declined as well as accepted.
- A section's header is its fold control and its background is canvas, so there is somewhere inside a section to start a drag; folding holds still, leaving what you pressed under the pointer.
- Rule names are abbreviated the way a logic text abbreviates them, with the full name on hover.
- Hover text now says what the box could not: a claim drawn in full with nothing recorded about it has no tooltip at all, and where there is one it carries the author's exact words, how far the claim stands from them, and what licensed the distance.
- A judgment has no abstract but it has facts, and the panel that opens a manuscript now says so and credits whoever wrote them.
- Four new instruments watch what the renderer paints, what it writes out, and whether the two sides of the graph boundary agree about names — the first of them found a defect that had been shipping.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.1.6
Changes
- A long conclusion edge climbing past a column of claims now goes round the whole stack with one clean elbow instead of weaving left and right past each box in turn — the slalom a reader reported on the Miller sample's 'Deriving the limit'.
- An edge arriving at a busy box now lands close to where it was naturally heading; arrivals used to be re-spaced evenly across the box's whole face, which could fling a nearly-vertical arrow to the far corner, across its own argument's departing edges.
- check_reconstruction now resolves every cited chapter and reports a missing file as a fault; a map whose every claim cited a non-existent source used to pass with "nothing to fix", since only quoted spans ever opened a file.
- The checker's verdict now says what it examined: verified rides beside ok, and next distinguishes "no faults" from "nothing was compared with a source", which read identically before.
- An unrecognised fidelity value — fidelity: "reported", say — is now reported with the five levels in scale order, instead of being silently treated as no marker at all.
- extract_text returns the opening lines of each converted file and says where the full files are, for hosted clients where the model and the server do not share a disk.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.
Ipsissima v0.1.5
Changes
- An argument's box now lists its whole premise-conclusion structure, every line under the file's own numbering; a line whose claim is drawn as its own box appears as a bracketed reference — (1) [Its Title] — and hovering the reference lights that box up on the map.
- A titled intermediary conclusion is now connected to the argument that concludes it, exactly as a main conclusion is; these claims used to float beside their own arguments with no edge in either direction, six arguments on one map among them.
- The numbers in the box now travel onto the arrows: each linked premise carries its line number at its foot on the inference bar, and a conclusion leaving the box carries its number beside the arrow, so the numbering on the map and in the box are one and the same.
- The inference bar takes its premises in reading order — left to right by line number, not by where each line happens to arrive from — and a premise's route is redrawn cleanly when that reordering leaves its old path dodging a box that is no longer in the way.
- Claims keep their words whatever label mode a file's front matter sets: a map with statementLabelMode "title" used to draw every box as a bare title with nothing behind it, on screen or in the tooltip.
- An open section's name is now set larger than the claims it heads (1.6x), so the heading stands out of the crowd instead of sitting level with it.
- The bar and its enclosure now count all of an inference step's premises, including any written inside the argument's box, rather than only the arrows that arrive.
What should I install?
Nothing, to try it. Download Ipsissima.html and double-click it: it works offline in any browser and makes no network requests of any kind. Drop a .argdown file onto it — or a whole folder, which brings the manuscript with it so claims can be laid out by where they appear in the text. Ipsissima.Reader.html is the same thing without the editor — the one to send to somebody you want to show a reconstruction to. New to argument maps? The walkthrough is the first entry under How to use and takes about two minutes.
Nothing, to read the worked examples. Four finished reconstructions, each opening with the text it was drawn from, are at jgsw.github.io/ipsissima; three more journal articles are in samples/.
The desktop application. Adds what a web page cannot do: open a .argdown by double-clicking it, save back in place, and reload the manuscript when it changes on disk. The .dmg is macOS (Intel and Apple Silicon both), the -setup.exe is Windows, and the .deb and .AppImage are Linux. The builds are unsigned, so the first launch is blocked once: on macOS, after dragging Ipsissima to Applications, allow it under System Settings → Privacy & Security → Open Anyway; on Windows, choose "More info" then "Run anyway". Installing Ipsissima shows every dialog before you meet it.
Ipsissima-MCP, for Claude Desktop. Download the .mcpb bundle and double-click it; Claude Desktop installs it and provisions Python and the dependencies itself. You also need Node on the machine — any current version.