Motifcode

<p align="center"> <img src="docs/logo.svg" alt="motifcode" width="912"> </p> <p align="center"> <strong>A coding agent harness built for one model: Motif-3.</strong> </p> <p align="center"> English &nbsp;·&nbsp; <a href="README.ko.md">한국어</a> </p> <p align="center"> <img src="https://img.shields.io/npm/v/motifcode?style=flat-square&labelColor=000000&color=333333" alt="npm"> <img src="https://img.shields.io/github/last-commit/TaewoooPark/Motifcode?style=flat-square&labelColor=000000&color=333333" alt="Last commit"> <img src="https://img.shields.io/github/actions/workflow/status/TaewoooPark/Motifcode/ci.yml?branch=main&style=flat-square&labelColor=000000&color=333333" alt="CI"> <img src="https://img.shields.io/badge/license-Apache--2.0-000000?style=flat-square&labelColor=000000&color=333333" alt="Apache-2.0"> &nbsp; <img src="https://img.shields.io/badge/TypeScript-000000?style=flat-square&logo=typescript&logoColor=white&labelColor=000000" alt="TypeScript"> <img src="https://img.shields.io/badge/Python-000000?style=flat-square&logo=python&logoColor=white&labelColor=000000" alt="Python"> <img src="https://img.shields.io/badge/Vitest-000000?style=flat-square&logo=vitest&logoColor=white&labelColor=000000" alt="Vitest"> &nbsp; <img src="https://img.shields.io/badge/Motif--3-000000?style=flat-square&labelColor=000000&color=000000" alt="Motif-3"> <img src="https://img.shields.io/badge/314B--A13B-000000?style=flat-square&labelColor=000000&color=000000" alt="314B-A13B"> <img src="https://img.shields.io/badge/256K%20context-000000?style=flat-square&labelColor=000000&color=000000" alt="256K context"> <img src="https://img.shields.io/badge/alpha-000000?style=flat-square&labelColor=000000&color=000000" alt="alpha"> </p> <p align="center"> <a href="https://discord.gg/5d99wCtzc"><img src="https://img.shields.io/badge/Join_OpenLab-Discord-5865F2?style=for-the-badge&amp;logo=discord&amp;logoColor=white&amp;labelColor=000000" alt="Join OpenLab on Discord"></a> </p>

Free through September 2026. Motif-3 is served by Infron as Motif: Motif 3 (Free) — $0 per million tokens in and out, the full 262,144-token window — and free access has been announced through the end of September 2026. An account and an API key are all it takes: npx motifcode asks for the key, then installs the motif command. Terms can change, and the model page is the source of truth.

Not an official Motif project. Motifcode is an independent open-source project. It is not certified, endorsed, sponsored or maintained by Motif Technologies or by Infron. Motif and Motif-3 are their names; this repository is only a client of the model.

Motifcode is a terminal coding agent in the shape of Claude Code — a transcript above, a bordered prompt below, / commands, @ mentions, a permission prompt, a .motif/ directory behind it — whose tool set, prompt layout, parser and failure handling are consequences of things that are specifically true about Motif-3, most of them measured rather than assumed. It is not a general harness pointed at a different base URL.

<br> <p align="center"> <img src="docs/screen-large.jpg" alt="motif in a wide terminal" width="912"> </p>

---

Why this exists

On 18 August 2026 Korea's Ministry of Science and ICT announced the second-stage result of its Independent AI Foundation Model programme (독자 AI 파운데이션 모델, the national sovereign-model project). Four teams were evaluated; LG AI Research, SK Telecom and Upstage went on to the next round, and Motif Technologies was eliminated — with the highest benchmark score of the four. The vice minister's explanation was that the technology was excellent but that the model "received a somewhat lower evaluation than the other companies on usability and applicability" (사용성·활용성). A week earlier Motif-3 had been released as open weights, scoring 47 on the Artificial Analysis Intelligence Index — first among Korean models. (THE ELEC, Biz Hankook, HelloT; the score has since been revised to 34 following changes to the scoring system)

Usability, for a coding model, is mostly not a property of the weights. It is whether the model's tool calls parse; whether the prompt is laid out the way its own chat template expects; whether one malformed turn is repaired or ends the session; whether the tools it is given are the ones it scored with; and whether the terminal in front of the person behaves like the tools they already use. Every one of those is a property of the harness — and a harness can be written by anyone.

Motifcode was built to prove that the usability an open-weight model was marked down on can be raised far enough with open source. The harness is written for this one model, measured against it, and given an interactive session checked feature by feature against Claude Code's.

---

What it looks like

<table> <tr> <td width="50%" align="center" valign="top"> <img src="docs/screen-large.jpg" alt="motif in a wide terminal" width="100%"><br> _{<b>Wide window.</b> The hero, the welcome card and the prompt.} </td> <td width="50%" align="center" valign="top"> <img src="docs/screen-small.jpg" alt="motif in a narrow terminal" width="100%"><br> _{<b>Narrow window.</b> The hero picks the size that fits; the session is the same.} </td> </tr> <tr> <td width="50%" align="center" valign="top"> <img src="docs/screen-login.jpg" alt="the first run asks for the API key" width="100%"><br> _{<b>First run.</b> The Infron API key is asked for in place of the prompt, checked, and saved once.} </td> <td width="50%" align="center" valign="top"> <img src="docs/screen-skills.jpg" alt="the /skills list" width="100%"><br> _{<b><code>/skills</code>.</b> The fifteen built-in skills, each of them also a command: <code>/commit fix the parser</code>.} </td> </tr> </table>

The hero fits the window; the welcome card says what to type; the first run asks for the key in place of the prompt. In a session, your line follows >, the model's prose and each tool call sit behind a ⏺, results under a ⎿, reasoning stays hidden unless you ask for it, and the status line shows the context used and how much of the prompt the server served from cache.

---

Install and use

Needs Node 20+. The package is one file with no runtime dependencies.

cd your-project
npx motifcode          # first run: asks for your key, then offers to install the `motif` command

The first session asks for your Infron API key, once, and saves it to ~/.motif/.env. Because npx leaves no command behind, it then offers to run npm install -g motifcode for you; say yes and motif (or motifcode) opens the session from any folder from then on. npm install -g motifcode directly does the same without the question.

| command | what it does | |---|---| | motif | open the interactive session in the current directory | | motif --continue | the same, with the latest conversation here loaded | | motif "<task>" | run one task and exit; --interactive stays in the session afterwards | | motif -p "<question>" | print only the final reply, for scripts and pipes | | motif login · motif logout | paste a key outside a session; remove the saved key | | motif doctor | probe the endpoint: auth, tool-call and reasoning parsers, prefix cache, channels | | motif sessions · motif resume <file> | list recorded sessions; resume an interrupted one | | motif skills · agents · plugins · config | what is loaded, and the effective settings with their sources | | motif trust | approve this repository's .motif/settings.json hooks |

Flags: --model, --endpoint, --env-file, --theme, --thinking, --verbose, --permissions ask|auto, --cwd, --channel, --max-turns, --max-output-tokens, --seed, --no-hero. motif --help has the full list.

---

Get an API key from Infron

Motif-3 is reached over Infron's OpenAI-compatible endpoint. The whole configuration is a base URL, a model id and a key:

| | | |---|---| | base URL | https://llm.onerouter.pro/v1 | | model | motif/motif-3 | | key | MOTIF_API_KEY |

1. Sign in at infron.ai/login (email or Google).
2. Open Dashboard → API Keys and click Add new key.
3. Run motif and paste the key when asked. It is checked against the endpoint with a one-token request, saved to ~/.motif/.env (readable only by you), and never shown to the model. motif login does the same outside a session, and /login and /logout inside one. A MOTIF_API_KEY in the environment or in a .env next to the project works too; --env-file <path> puts a file first.
4. motif doctor confirms the connection and reports how the server returns tool calls and reasoning and whether prefix caching is on.

Free through September 2026. At the time of writing Infron lists the model as Motif: Motif 3 (Free) at $0 per million tokens for input and output, and has announced free access through the end of September 2026. Check the model page and Infron's free-model terms for the current conditions.

Only MOTIF_* keys are read from a .env file, none of them are exported, and the key is removed from the harness's own environment before anything is spawned — the agent's bash cannot see it, and neither can a project hook.

---

Commands and keys

| command | what it does | |---|---| | /help | commands and keys | | /status (/cost) | connection, settings and session totals | | /config | effective settings, where each came from, and the files | | /doctor | probe the endpoint: auth, parsers, cache, channels | | /login, /logout | paste an Infron API key, checked and saved to ~/.motif/.env; remove the saved key | | /model [id], /endpoint [url] | show or set the model id or endpoint for the next task | | /channel [toolcall\|object\|raw] | show or set the action channel; changing it restarts the conversation | | /max-turns [n], /max-tokens [n\|off], /seed [n\|off] | per-task ceilings and the sampling seed | | /theme [name] | show, list or set the colour theme | | /thinking | show or hide the model's reasoning | | /compact [focus] | replace the transcript with the model's summary of it; words after it say what to keep | | /compact-at [0.5-1] | the context fraction at which compaction runs (default 0.75) | | /permissions [ask\|auto] | ask before commands, writes and patches run, or run everything | | /cwd [path] | show or change the working directory | | /notes (/memory), /hooks | the project notes every task reads; the hooks around tools | | /skills, /agents, /plugins | what is loaded; each skill also runs as /<skill> [input] | | /new (/clear) | start a new conversation; the working tree is untouched | | /sessions, /resume [n\|file] | recorded sessions; continue from one | | /quit (/exit, /q) | leave |

enter send · \ + enter newline · esc interrupt or clear · ctrl-c twice quit · ctrl-d quit
↑ ↓ history · tab show or hide reasoning · ctrl-o full tool output · ctrl-l redraw · shift-tab permissions
@ attach a file · ! run a shell line · # add a project note · / commands · ? hide this

---

Features

| area | what you get | |---|---| | Session | Replies stream in as the model writes; reasoning stays out of the transcript unless --thinking or /thinking asks for it; tool calls behind ⏺, results