opencode-navigator 0.17.3 → 0.18.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## [0.18.0] - 2026-10-01
+
+- Add durable per-session Todo lists to OpenCode 2.x through a separately configured Navigator server plugin and an agent Todo tool.
+- Update Todo in the sidebar as tasks change, and offer an off-by-default per-session switch for model-context Todo instructions.
+- Keep Todo visible with setup guidance when the OpenCode 2.x server plugin is missing.
+
 ## [0.17.3] - 2026-09-30
 
 ## [0.17.2] - 2026-09-30
@@ -30,6 +36,7 @@
 
 Earlier release notes are available on [GitHub Releases](https://github.com/St1ggy/opencode-navigator/releases).
 
+[0.18.0]: https://github.com/St1ggy/opencode-navigator/compare/v0.17.3...v0.18.0
 [0.17.3]: https://github.com/St1ggy/opencode-navigator/compare/v0.17.2...v0.17.3
 [0.17.2]: https://github.com/St1ggy/opencode-navigator/compare/v0.17.1...v0.17.2
 [0.17.1]: https://github.com/St1ggy/opencode-navigator/compare/v0.17.0...v0.17.1

package/README.md

@@ -12,7 +12,7 @@ See the [changelog](CHANGELOG.md) for release-by-release changes.
 
 - Theme-aware session title with the session creation date
 - First-run setup guide with interactive section settings
-- Collapsible Todo section with status filters, grouped tasks, progress and priority indicators
+- Collapsible Todo section with status filters, grouped tasks, progress and priority indicators; OpenCode 2 adds session-owned tasks and optional model-context instructions
 - Active subagent list with live statuses and click-to-open navigation, including dev-team workers running in separate local processes
 - Compact, searchable workspace skill list with user-wide favorites, recent skills, source details, and click-to-confirm slash commands
 - Configurable host quick actions, including the auto-approve toggle, with user-wide bookmarks and availability reasons
@@ -42,8 +42,9 @@ collapsed. Use `Save current layout as default` in sidebar settings to reuse the
 current visible/hidden, expanded/collapsed, and ordering states in new sessions.
 
 Supports OpenCode 1.18.30 and newer, including OpenCode 2.x. OpenCode 2.0.16 does
-not expose Todo or LSP data to TUI plugins. Navigator keeps Todo visible with an
-explicit unsupported-host message and hides LSP on 2.x while retaining Subagents,
+not expose host Todo or LSP data to TUI plugins. Navigator supplies its own
+session Todo list through a separately configured server plugin in 2.x. Without
+that plugin, Todo stays visible with setup guidance. LSP is hidden on 2.x while retaining Subagents,
 Skills, Quick Actions, MCP, Search, settings, and presets. All interface icons use Nerd Font glyphs by
 default (Codicons for controls, keyboard symbols for hints, language logos for LSP). Use a Nerd Fonts v3
 terminal font, or select **Settings → Behavior → Icon style → Text fallback**.
@@ -168,6 +169,26 @@ OpenCode 2.x CLI plugins are global terminal settings; there is no project-local
 plugin overrides are required. OpenCode validates `cli.json` strictly, so keep it
 within the linked schema and restart OpenCode after changing it.
 
+To enable Todo in OpenCode 2.x, also install the **server** half of Navigator.
+Add the same package to `~/.config/opencode/opencode.json` (or the project
+`opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-navigator"]
+}
+```
+
+For a local source installation, use the directory containing Navigator's
+`server.js` in the `plugin` array. Keep the TUI package in `cli.json` as above;
+the server configuration alone does not replace it. Restart OpenCode after
+configuring both. Todo items belong to the current session, survive restarts,
+and update in the sidebar when the agent calls `navigator_todo_write`. The
+**Todo instructions: Off/On** control in the Todo section is session-scoped and
+starts **Off**: tasks and the agent tool work without adding Todo instructions
+to the model's context. OpenCode 1.x continues to show the host's Todo list.
+
 ### Install the corner font
 
 **Required for rounded multiline selections in Nerd Font mode.** Run the font
@@ -509,8 +530,8 @@ root order. Activate any badge, including a custom server, to toggle its full ID
 in place. Navigator does not open a root/status dialog because OpenCode may report
 an empty root and does not expose the underlying diagnostic error text.
 
-Todo priorities are read-only because OpenCode does not expose a Todo mutation
-API to TUI plugins.
+Todo priorities are read-only in the sidebar. OpenCode 1.x provides host Todo
+data without a TUI mutation API; on 2.x, Navigator's agent tool writes tasks.
 
 Todo offers `All`, `Active`, and `Finished` views with counts. Active shows running
 tasks before pending tasks. Finished contains separate Completed and Cancelled

package/dist/rpc.js

@@ -0,0 +1,15 @@
+var item={type:"object",properties:{content:{type:"string",minLength:1,maxLength:512},status:{type:"string",enum:["pending","in_progress","completed","cancelled"]},priority:{type:"string",enum:["high","medium","low"]}},required:["content","status"],additionalProperties:false
+}
+var todos={type:"array",items:item,maxItems:100}
+var sessionID={type:"string",minLength:1}
+var output={type:"object",properties:{todos,guidance:{type:"boolean"}},required:["todos","guidance"],additionalProperties:false
+}
+var NavigatorTodoRpc={id:"opencode-navigator.todo",methods:{list:{input:{type:"object",properties:{sessionID},required:["sessionID"],additionalProperties:false},output
+},replace:{input:{type:"object",properties:{sessionID,todos},required:["sessionID","todos"],additionalProperties:false
+},output
+},guidance:{input:{type:"object",properties:{sessionID,enabled:{type:"boolean"}},required:["sessionID","enabled"],additionalProperties:false
+},output
+}},events:{updated:{schema:{type:"object",properties:{sessionID,todos,guidance:{type:"boolean"}},required:["sessionID","todos","guidance"],additionalProperties:false
+}}}}
+export{NavigatorTodoRpc
+}

package/dist/server.js

@@ -0,0 +1,72 @@
+import {Plugin} from "@opencode/plugin"
+function normalizeTodoState(value){if(!value||typeof value!=="object")
+return{todos:[],guidance:false}
+const state=value
+const statuses=new Set(["pending","in_progress","completed","cancelled"])
+const priorities=new Set(["high","medium","low"])
+const todos=Array.isArray(state.todos)?state.todos.filter((item)=>item&&typeof item.content==="string"&&item.content.trim().length>0&&item.content.length<=512&&statuses.has(item.status)).slice(0,100).map((item)=>({content:item.content.trim(),status:item.status,...priorities.has(item.priority??"")&&{priority:item.priority}})):[]
+return{todos,guidance:state.guidance===true}}
+function todoGuidance(state){const lines=state.todos.map((todo)=>`- [${todo.status}] ${todo.content}`)
+return ["Navigator Todo: when work has multiple steps, use navigator_todo_write to keep the session Todo list current.","Mark work in progress, completed, or cancelled as it changes; avoid claiming unfinished work is done.",...lines.length>0?["Current Navigator Todo items:",...lines]:[]].join(`
+`)
+}
+function key(sessionID){return `session.todo.${sessionID}`
+}
+function createManagedTodos(storage,onChange){const pending=new Map
+async function list(sessionID){return normalizeTodoState(await storage.get(key(sessionID)))
+}
+function change(sessionID,apply){const request=(pending.get(sessionID)??Promise.resolve()).catch(()=>{}).then(async ()=>{const next=apply(await list(sessionID))
+await storage.set(key(sessionID),next)
+await onChange(sessionID,next)
+return next
+})
+pending.set(sessionID,request)
+const clear=()=>{if(pending.get(sessionID)===request)
+pending.delete(sessionID)
+}
+request.then(clear).catch(clear)
+return request
+}
+return{list,replace(sessionID,todos){return change(sessionID,(current)=>({...current,todos:normalizeTodoState({todos}).todos}))
+},guidance(sessionID,enabled){return change(sessionID,(current)=>({...current,guidance:enabled}))
+}}}
+var item={type:"object",properties:{content:{type:"string",minLength:1,maxLength:512},status:{type:"string",enum:["pending","in_progress","completed","cancelled"]},priority:{type:"string",enum:["high","medium","low"]}},required:["content","status"],additionalProperties:false
+}
+var todos={type:"array",items:item,maxItems:100}
+var sessionID={type:"string",minLength:1}
+var output={type:"object",properties:{todos,guidance:{type:"boolean"}},required:["todos","guidance"],additionalProperties:false
+}
+var NavigatorTodoRpc={id:"opencode-navigator.todo",methods:{list:{input:{type:"object",properties:{sessionID},required:["sessionID"],additionalProperties:false},output
+},replace:{input:{type:"object",properties:{sessionID,todos},required:["sessionID","todos"],additionalProperties:false
+},output
+},guidance:{input:{type:"object",properties:{sessionID,enabled:{type:"boolean"}},required:["sessionID","enabled"],additionalProperties:false
+},output
+}},events:{updated:{schema:{type:"object",properties:{sessionID,todos,guidance:{type:"boolean"}},required:["sessionID","todos","guidance"],additionalProperties:false
+}}}};
+var input={type:"object",properties:{todos:NavigatorTodoRpc.methods.replace.input.properties.todos
+},required:["todos"],additionalProperties:false
+}
+var noNotify=async ()=>{}
+var todo_server_default=Plugin.define({id:"opencode-navigator.todo-server",async setup(host){let notify=noNotify
+const todos=createManagedTodos({get:(key)=>host.storage.get(key),set:(key,value)=>host.storage.set(key,value)
+},(sessionID,state)=>notify(sessionID,state))
+const rpc=await host.rpc.register(NavigatorTodoRpc,{list:async (value)=>todos.list(value.sessionID),replace:async (value)=>{const{sessionID,todos:items}=value
+return todos.replace(sessionID,items)
+},guidance:async (value)=>{const{sessionID,enabled}=value
+return todos.guidance(sessionID,enabled)
+}})
+notify=(sessionID,state)=>rpc.events.emit("updated",{sessionID,...state})
+const tools=await host.tool.transform((editor)=>{editor.namespace({name:"navigator",description:"Navigator session tasks"})
+editor.add({name:"todo_write",description:"Replace the Navigator Todo list for this session with the current tasks and their statuses.",input,options:{namespace:"navigator"},execute:async (value,context)=>{const state=await todos.replace(context.sessionID,value.todos)
+return{content:`Navigator Todo updated: ${state.todos.length} tasks.`}}})
+})
+const context=await host.session.hook("context",async (event)=>{const state=await todos.list(event.sessionID)
+if(state.guidance)
+event.system.push({type:"text",text:todoGuidance(state)})
+})
+return async ()=>{await context.dispose()
+await tools.dispose()
+await rpc.dispose()
+}}})
+export{todo_server_default as default
+}

package/dist/tui.js

@@ -2,7 +2,7 @@ import {insert as _$insert,setProp as _$setProp,createElement as _$createElement
 
 
 
-import {createSignal as createSignal2,createSignal,createEffect,onCleanup,createContext,useContext,createContext as createContext2,createSignal as createSignal3,useContext as useContext2,createEffect as createEffect2,splitProps,untrack,splitProps as splitProps2,For,createEffect as createEffect3,onCleanup as onCleanup2,Show,splitProps as splitProps3,createSignal as createSignal4,createSignal as createSignal5,createSignal as createSignal6,onCleanup as onCleanup3,batch,createSignal as createSignal8,createSignal as createSignal7,createEffect as createEffect4,createSignal as createSignal9,onCleanup as onCleanup4,createSignal as createSignal10,Index,createSignal as createSignal11,onCleanup as onCleanup5,createEffect as createEffect6,onCleanup as onCleanup7,batch as batch2,createEffect as createEffect5,createMemo,createSignal as createSignal12,onCleanup as onCleanup6,onMount,For as For2,For as For3,Show as Show2,createMemo as createMemo2,Show as Show3,createSignal as createSignal13,onCleanup as onCleanup8,For as For4,For as For5,For as For8,createMemo as createMemo4,onMount as onMount3,For as For7,createMemo as createMemo3,onMount as onMount2,Show as Show5,createEffect as createEffect7,createSignal as createSignal14,onCleanup as onCleanup9,Show as Show4,For as For6,For as For9,createEffect as createEffect8,createMemo as createMemo5,onCleanup as onCleanup10,For as For10,createEffect as createEffect9,createMemo as createMemo8,onCleanup as onCleanup11,onMount as onMount4,createMemo as createMemo6,createMemo as createMemo7,Show as Show6,onCleanup as onCleanup12,createSignal as createSignal15,createEffect as createEffect10,onCleanup as onCleanup13,onMount as onMount5,onCleanup as onCleanup14,onMount as onMount6,For as For11,createSignal as createSignal16,createSignal as createSignal17,Show as Show7,createSignal as createSignal19,createSignal as createSignal18,onCleanup as onCleanup15,For as For12,Show as Show10,createMemo as createMemo10,createComputed,createMemo as createMemo9,createSignal as createSignal20,untrack as untrack2,Show as Show8,createComputed as createComputed2,untrack as untrack3,Show as Show9,createEffect as createEffect11,createSignal as createSignal21,createMemo as createMemo12,createSignal as createSignal23,createMemo as createMemo11,For as For13,Show as Show13,Show as Show11,Show as Show12,createSignal as createSignal22,onCleanup as onCleanup16,For as For14,Show as Show15,createMemo as createMemo14,Show as Show14,createMemo as createMemo13,createEffect as createEffect12,onCleanup as onCleanup17,For as For19,Match,Switch,createMemo as createMemo18,onCleanup as onCleanup21,For as For15,Show as Show16,createSignal as createSignal24,createEffect as createEffect13,createMemo as createMemo15,onCleanup as onCleanup18,untrack as untrack4,For as For17,Show as Show19,createEffect as createEffect14,createMemo as createMemo16,createSignal as createSignal25,onCleanup as onCleanup19,untrack as untrack5,For as For16,Show as Show18,Show as Show17,Show as Show22,createEffect as createEffect15,createMemo as createMemo17,createSignal as createSignal26,onCleanup as onCleanup20,untrack as untrack6,For as For18,Show as Show21,Show as Show20,createEffect as createEffect16,createMemo as createMemo19,onCleanup as onCleanup22,untrack as untrack7,Show as Show23,createMemo as createMemo20,onCleanup as onCleanup23,createSignal as createSignal27,onCleanup as onCleanup24,onMount as onMount7} from "solid-js"
+import {createSignal as createSignal2,createSignal,createEffect,onCleanup,createContext,useContext,createContext as createContext2,createSignal as createSignal3,useContext as useContext2,createEffect as createEffect2,splitProps,untrack,splitProps as splitProps2,For,createEffect as createEffect3,onCleanup as onCleanup2,Show,splitProps as splitProps3,createSignal as createSignal4,createSignal as createSignal5,createSignal as createSignal6,onCleanup as onCleanup3,batch,createSignal as createSignal8,createSignal as createSignal7,createEffect as createEffect4,createSignal as createSignal9,onCleanup as onCleanup4,createSignal as createSignal10,createSignal as createSignal11,Index,createSignal as createSignal12,onCleanup as onCleanup5,createEffect as createEffect6,onCleanup as onCleanup7,batch as batch2,createEffect as createEffect5,createMemo,createSignal as createSignal13,onCleanup as onCleanup6,onMount,For as For2,For as For3,Show as Show2,createMemo as createMemo2,Show as Show3,createSignal as createSignal14,onCleanup as onCleanup8,For as For4,For as For5,For as For8,createMemo as createMemo4,onMount as onMount3,For as For7,createMemo as createMemo3,onMount as onMount2,Show as Show5,createEffect as createEffect7,createSignal as createSignal15,onCleanup as onCleanup9,Show as Show4,For as For6,For as For9,createEffect as createEffect8,createMemo as createMemo5,onCleanup as onCleanup10,For as For10,createEffect as createEffect9,createMemo as createMemo8,onCleanup as onCleanup11,onMount as onMount4,createMemo as createMemo6,createMemo as createMemo7,Show as Show6,onCleanup as onCleanup12,createSignal as createSignal16,createEffect as createEffect10,onCleanup as onCleanup13,onMount as onMount5,onCleanup as onCleanup14,onMount as onMount6,For as For11,createSignal as createSignal17,createSignal as createSignal18,Show as Show7,createSignal as createSignal20,createSignal as createSignal19,onCleanup as onCleanup15,For as For12,Show as Show10,createMemo as createMemo10,createComputed,createMemo as createMemo9,createSignal as createSignal21,untrack as untrack2,Show as Show8,createComputed as createComputed2,untrack as untrack3,Show as Show9,createEffect as createEffect11,createSignal as createSignal22,createMemo as createMemo12,createSignal as createSignal24,createMemo as createMemo11,For as For13,Show as Show13,Show as Show11,Show as Show12,createSignal as createSignal23,onCleanup as onCleanup16,For as For14,Show as Show15,createMemo as createMemo14,Show as Show14,createMemo as createMemo13,createEffect as createEffect12,onCleanup as onCleanup17,For as For19,Match,Switch,createMemo as createMemo18,onCleanup as onCleanup21,For as For15,Show as Show16,createSignal as createSignal25,createEffect as createEffect13,createMemo as createMemo15,onCleanup as onCleanup18,untrack as untrack4,For as For17,Show as Show19,createEffect as createEffect14,createMemo as createMemo16,createSignal as createSignal26,onCleanup as onCleanup19,untrack as untrack5,For as For16,Show as Show18,Show as Show17,Show as Show23,createEffect as createEffect15,createMemo as createMemo17,createSignal as createSignal27,onCleanup as onCleanup20,untrack as untrack6,For as For18,Show as Show21,Show as Show20,Show as Show22,createEffect as createEffect16,createMemo as createMemo19,onCleanup as onCleanup22,untrack as untrack7,Show as Show24,createMemo as createMemo20,onCleanup as onCleanup23,createSignal as createSignal28,onCleanup as onCleanup24,onMount as onMount7} from "solid-js"
 var SIDEBAR_SECTIONS=["todo","subagents","skills","quick_actions","lsp","mcp"]
 var QUICK_ACTION_IDS=["session.rename","session.timeline","session.copy","session.export","session.compact","session.list","session.new","session.fork","messages.copy","session.first","session.last","session.messages_last_user","session.message.next","session.message.previous","permission.mode"]
 function preferencesScope(path){return path.worktree||path.directory||"global"
@@ -2619,6 +2619,99 @@ activeTarget=undefined
 requests.abortAll()
 refreshing.clear()
 }}}}
+function normalizeTodoState(value){if(!value||typeof value!=="object")
+return{todos:[],guidance:false}
+const state=value
+const statuses=new Set(["pending","in_progress","completed","cancelled"])
+const priorities=new Set(["high","medium","low"])
+const todos=Array.isArray(state.todos)?state.todos.filter((item)=>item&&typeof item.content==="string"&&item.content.trim().length>0&&item.content.length<=512&&statuses.has(item.status)).slice(0,100).map((item)=>({content:item.content.trim(),status:item.status,...priorities.has(item.priority??"")&&{priority:item.priority}})):[]
+return{todos,guidance:state.guidance===true}}
+
+var item={type:"object",properties:{content:{type:"string",minLength:1,maxLength:512},status:{type:"string",enum:["pending","in_progress","completed","cancelled"]},priority:{type:"string",enum:["high","medium","low"]}},required:["content","status"],additionalProperties:false
+}
+var todos={type:"array",items:item,maxItems:100}
+var sessionID={type:"string",minLength:1}
+var output={type:"object",properties:{todos,guidance:{type:"boolean"}},required:["todos","guidance"],additionalProperties:false
+}
+var NavigatorTodoRpc={id:"opencode-navigator.todo",methods:{list:{input:{type:"object",properties:{sessionID},required:["sessionID"],additionalProperties:false},output
+},replace:{input:{type:"object",properties:{sessionID,todos},required:["sessionID","todos"],additionalProperties:false
+},output
+},guidance:{input:{type:"object",properties:{sessionID,enabled:{type:"boolean"}},required:["sessionID","enabled"],additionalProperties:false
+},output
+}},events:{updated:{schema:{type:"object",properties:{sessionID,todos,guidance:{type:"boolean"}},required:["sessionID","todos","guidance"],additionalProperties:false
+}}}};
+function createNavigatorTodoController(context,api){const rpc=context.client.rpc(NavigatorTodoRpc)
+const [sessions,setSessions]=createSignal11({})
+const [saving,setSaving]=createSignal11({})
+const [errors,setErrors]=createSignal11({})
+const requests=createRequestState(api.lifecycle.signal)
+const refreshing=new Map
+const revisions=new Map
+let activeTarget
+function target(sessionID){const session=api.state.session.get(sessionID)
+const directory=session?.directory??api.state.path.directory
+const workspace=session?.workspaceID
+return{key:JSON.stringify([sessionID,directory,workspace??null]),sessionID,routing:{directory}}}
+function set(key,value){setSessions((current)=>({...current,[key]:normalizeTodoState(value)}))
+}
+function refresh(sessionID,force=false){const current=target(sessionID)
+const pending=refreshing.get(current.key)
+if(pending&&!force)
+return pending
+const revision=revisions.get(current.key)??0
+const requestState=requests.start(current.key,"refresh Navigator todos",current.key in sessions(),force)
+if(!requestState)
+return pending
+const request=rpc.list({sessionID},{location:current.routing,signal:requestState.signal}).then((value)=>{const state=normalizeTodoState(value)
+if(requestState.isCurrent()&&(revisions.get(current.key)??0)===revision)
+set(current.key,state)
+requestState.succeed()
+return state
+}).catch((error)=>{requestState.fail(error)
+throw error
+}).finally(()=>{requestState.finish()
+if(refreshing.get(current.key)===request)
+refreshing.delete(current.key)
+})
+refreshing.set(current.key,request)
+return request
+}
+const unsubscribe=rpc.events.on("updated",(event)=>{const{sessionID}=event.data
+if(typeof sessionID!=="string")
+return
+const current=target(sessionID)
+if(event.location.directory!==current.routing.directory)
+return
+revisions.set(current.key,(revisions.get(current.key)??0) + 1)
+set(current.key,normalizeTodoState(event.data))
+})
+api.lifecycle.onDispose(unsubscribe)
+return{target,list(sessionID){return sessions()[target(sessionID).key]?.todos??[]
+},refresh,state(sessionID){return requests.state(target(sessionID).key)
+},retry(sessionID){return refresh(sessionID,true)
+},guidance(sessionID){const key=target(sessionID).key
+return{enabled:sessions()[key]?.guidance??false,saving:saving()[key]??false,error:errors()[key],available:key in sessions()
+}},async setGuidance(sessionID,enabled){const current=target(sessionID)
+if(!(current.key in sessions())||saving()[current.key])
+return
+setSaving((value)=>({...value,[current.key]:true}))
+setErrors((value)=>({...value,[current.key]:undefined}))
+try{const state=await rpc.guidance({sessionID,enabled},{location:current.routing})
+revisions.set(current.key,(revisions.get(current.key)??0) + 1)
+set(current.key,normalizeTodoState(state))
+} catch(error){setErrors((value)=>({...value,[current.key]:error instanceof Error?error.message:String(error)}))
+} finally{setSaving((value)=>({...value,[current.key]:false}))
+}},activate(sessionID){const key=target(sessionID).key
+if(activeTarget!==key){requests.abortAll()
+refreshing.clear()
+activeTarget=key
+}
+return()=>{if(activeTarget!==key)
+return
+activeTarget=undefined
+requests.abortAll()
+refreshing.clear()
+}}}}
 function buildTodoView(todos,mode){const active=[...todos.filter((item)=>item.status==="in_progress"),...todos.filter((item)=>item.status==="pending")]
 const completed=todos.filter((item)=>item.status==="completed")
 const cancelled=todos.filter((item)=>item.status==="cancelled")
@@ -2673,7 +2766,7 @@ return action.label
 const command=api.keymap.getCommands?.({visibility:"registered"}).find((candidate)=>candidate.name===action.command)
 return typeof command?.title==="string"?command.title:action.label
 }
-function createQuickActionRevision(api){const [revision,setRevision]=createSignal11(0)
+function createQuickActionRevision(api){const [revision,setRevision]=createSignal12(0)
 const unsubscribe=api.keymap.on?.("state",()=>setRevision((value)=>value + 1))
 if(unsubscribe)
 onCleanup5(unsubscribe)
@@ -2771,7 +2864,7 @@ const [selectedID,setSelectedID]=useDialogState("selection",undefined)
 const [views]=useDialogState("tab-views",new Map)
 const tabViews=views()
 const [scrollTop,setScrollTop]=useDialogState("scroll",0)
-const [refreshing,setRefreshing]=createSignal12(false)
+const [refreshing,setRefreshing]=createSignal13(false)
 const theme=()=>props.api.theme.current
 const icons=useIcons()
 const commandRevision=createQuickActionRevision(props.api)
@@ -3397,8 +3490,8 @@ return _el$
 }
 function FirstRunWizard(props){const icons=useIcons()
 const dialogs=useDialogs(props.api)
-const [active,setActive]=createSignal13(0)
-const [step,setStep]=createSignal13(0)
+const [active,setActive]=createSignal14(0)
+const [step,setStep]=createSignal14(0)
 const theme=()=>props.api.theme.current
 const sections=SECTION_DEFINITIONS.filter((section)=>supportsSidebarSection(props.api,section.name))
 const finishIndex=sections.length
@@ -3586,7 +3679,7 @@ const dialogs=useDialogs(props.api)
 const theme=()=>props.api.theme.current
 const dimensions=useTerminalDimensions4()
 const scroll=useDialogScroll()
-const [active,setActive]=createSignal14("apply")
+const [active,setActive]=createSignal15("apply")
 let body
 const prefix=`${PLUGIN_ID}.preset-preview`
 function activate(action){if(!props.valid()){dialogs.close()
@@ -4628,7 +4721,7 @@ return _$createElement("box")
 
 
 function SettingsFooterButton(props){const icons=useIcons()
-const [hovered,setHovered]=createSignal15(false)
+const [hovered,setHovered]=createSignal16(false)
 const theme=()=>props.api.theme.current
 return _$createComponent(IconControl,{id:`${PLUGIN_ID}.settings.footer`,get icon(){return icons.icon("settings")
 },get foregroundColor(){return _$memo(()=>!!hovered())()?theme().text:theme().textMuted
@@ -4849,8 +4942,8 @@ return _$createElement("box")
 
 var NAVIGATOR_PACKAGE_URL="https://registry.npmjs.org/opencode-navigator/latest"
 var REQUEST_TIMEOUT_MS=5000
-function createVersionStatus(api,navigatorVersion,request=fetch){const [openCodeUpdate,setOpenCodeUpdate]=createSignal16()
-const [navigatorUpdate,setNavigatorUpdate]=createSignal16()
+function createVersionStatus(api,navigatorVersion,request=fetch){const [openCodeUpdate,setOpenCodeUpdate]=createSignal17()
+const [navigatorUpdate,setNavigatorUpdate]=createSignal17()
 const controller=new AbortController
 const timeout=setTimeout(()=>controller.abort(),REQUEST_TIMEOUT_MS)
 const unsubscribe=api.event.on("installation.update-available",(event)=>{const version=event.properties.version
@@ -5013,9 +5106,9 @@ return false
 return true
 }
 function createSidebarInteraction(api,showHelp=()=>openKeyboardHelp(api)){const descriptors=new Map
-const [selectedId,setSelectedId]=createSignal17()
-const [focusWithin,setFocusWithin]=createSignal17(false)
-const [revision,setRevision]=createSignal17(0)
+const [selectedId,setSelectedId]=createSignal18()
+const [focusWithin,setFocusWithin]=createSignal18(false)
+const [revision,setRevision]=createSignal18(0)
 let titleRoot
 let contentRoot
 let targetedRoot
@@ -5284,7 +5377,7 @@ else if(highlighted)
 foregroundColor=theme.selectedListItemText
 return{backgroundColor,foregroundColor}}
 function useSidebarItem(api,interaction,descriptor,normalColor=()=>api.theme.current.text,mode="row"){let unregister
-const [hovered,setHovered]=createSignal18(false)
+const [hovered,setHovered]=createSignal19(false)
 const disabled=()=>descriptor.disabled?.()===true
 const focused=()=>Boolean(interaction?.ownsFocus()&&interaction.isSelected(descriptor.id))
 const colors=()=>sidebarInteractiveColors(api.theme.current,{focused:focused(),hovered:hovered(),disabled:disabled()},normalColor(),mode)
@@ -5302,7 +5395,7 @@ return true
 }}}
 function LspBadge(props){const icons=useIcons()
 const isKnown=lspIconName(props.id)!==undefined
-const [showName,setShowName]=createSignal19(false)
+const [showName,setShowName]=createSignal20(false)
 const statusColor=()=>props.status==="connected"?props.api.theme.current.success:props.api.theme.current.error
 if(!isKnown){return(()=>{var _el$=_$createElement("text")
 _$setProp(_el$,"flexShrink",1)
@@ -5345,7 +5438,7 @@ return _el$3
 
 
 
-function createListVisibility(options){const [expanded,setExpanded]=createSignal20(false)
+function createListVisibility(options){const [expanded,setExpanded]=createSignal21(false)
 let previousKey
 let previousLimit
 const canToggle=createMemo9(()=>options.limit()>0&&options.items().length>options.limit())
@@ -5427,7 +5520,7 @@ result += segment
 return result + ellipsis
 }
 function Section(props){const icons=useIcons()
-const [actionWidth,setActionWidth]=createSignal21()
+const [actionWidth,setActionWidth]=createSignal22()
 const icon=()=>props.section?icons.section(props.section):props.icon
 const theme=()=>props.api.theme.current
 const item=useSidebarItem(props.api,props.interaction,{id:props.sectionId??`section.${props.title}`,position:()=>({section:props.navigationSection??0,row:0,column:0
@@ -5778,7 +5871,7 @@ return _el$2
 function SectionFilter(props){const icons=useIcons()
 let input
 let unregisterInput
-const [inputFocused,setInputFocused]=createSignal22(false)
+const [inputFocused,setInputFocused]=createSignal23(false)
 const theme=()=>props.api.theme.current
 const item=useSidebarItem(props.api,props.interaction,{id:props.id??`filter.${props.placeholder}`,position:()=>props.position??{section:0,row:0,column:0
 },activate:()=>{if(!input)
@@ -5953,7 +6046,7 @@ return _el$
 }})
 }
 function McpSection(props){const icons=useIcons()
-const [query,setQuery]=createSignal23("")
+const [query,setQuery]=createSignal24("")
 const model=createMcpSectionModel(props,query)
 const navigationSection=()=>props.navigationSection??6
 const summary=createMemo12(()=>`${model.active()}/${model.list().length}${model.errors() ? ` \xB7 ${model.errors()} ${icons.icon("error")}` : ""}`)
@@ -6299,7 +6392,7 @@ return _el$2
 }})
 }
 function SkillsSection(props){const dialogs=useDialogs(props.api)
-const [query,setQuery]=createSignal24("")
+const [query,setQuery]=createSignal25("")
 const model=createSkillSectionModel(props,query)
 const navigationSection=()=>props.navigationSection??3
 function selectSkill(item){if(!props.preferences.shouldConfirmSkill(item)){model.useSkill(item)
@@ -6374,8 +6467,8 @@ return _el$
 function createSubagentSectionModel(props){const list=createMemo16(()=>props.controller.list(props.sessionID))
 const recent=createMemo16(()=>props.controller.recent?.(props.sessionID)??[])
 const rows=createMemo16(()=>buildSubagentView(list(),recent()))
-const [query,setQuery]=createSignal25("")
-const [mode,setMode]=createSignal25("all")
+const [query,setQuery]=createSignal26("")
+const [mode,setMode]=createSignal26("all")
 const counts=createMemo16(()=>countSubagentView(rows(),query()))
 const tabs=createMemo16(()=>["all","active","recent",...counts().errors>0?["errors"]:[]])
 const filtered=createMemo16(()=>filterSubagentView(rows(),mode(),query()))
@@ -6657,6 +6750,7 @@ return _el$
 })()
 }
 function TodoContents(props){const navigationSection=()=>props.navigationSection??1
+const tabsRow=()=>props.managed?3:2
 return(()=>{var _el$=_$createElement("box"),_el$2=_$createElement("box")
 _$insertNode(_el$,_el$2)
 _$setProp(_el$,"gap",1)
@@ -6664,7 +6758,7 @@ _$setProp(_el$2,"flexDirection","row")
 _$setProp(_el$2,"flexWrap","wrap")
 _$insert(_el$2,_$createComponent(For18,{each:["all","active","finished"],children:(value,index)=>_$createComponent(SectionTab,{get api(){return props.api
 },get interaction(){return props.interaction
-},id:`${PLUGIN_ID}.todo.filter.${value}`,get position(){return{section:navigationSection(),row:2,column:index()
+},id:`${PLUGIN_ID}.todo.filter.${value}`,get position(){return{section:navigationSection(),row:tabsRow(),column:index()
 }},get label(){return value[0].toUpperCase() + value.slice(1)
 },get count(){return props.view.counts[value]
 },get selected(){return props.mode===value
@@ -6698,7 +6792,8 @@ return _el$3
 _$insert(_el$,_$createComponent(ListVisibilityControl,{get api(){return props.api
 },get interaction(){return props.interaction
 },section:"todo",get navigationSection(){return navigationSection()
-},row:3,get visibility(){return props.visibility
+},get row(){return tabsRow() + 1
+},get visibility(){return props.visibility
 }}),null)
 return _el$
 })()
@@ -6709,10 +6804,39 @@ _$effect((_$p)=>_$setProp(_el$6,"fg",props.api.theme.current.textMuted,_$p))
 return _el$6
 })()
 }
+
+
+
+
+
+
+function TodoGuidanceControl(props){const state=()=>props.controller.guidance(props.sessionID)
+return _$createComponent(Show22,{get when(){return state().available
+},get children(){var _el$=_$createElement("box")
+_$insert(_el$,_$createComponent(SectionTab,{get api(){return props.api
+},get interaction(){return props.interaction
+},id:`${PLUGIN_ID}.todo.guidance`,get position(){return{section:props.navigationSection,row:2,column:0
+}},get label(){return `Todo instructions: ${state().enabled ? "On" : "Off"}`
+},get selected(){return state().enabled
+},get disabled(){return state().saving
+},onActivate:()=>void props.controller.setGuidance(props.sessionID,!state().enabled)
+}),null)
+_$insert(_el$,_$createComponent(Show22,{get when(){return state().error
+},children:(message)=>(()=>{var _el$2=_$createElement("text")
+_$setProp(_el$2,"wrapMode","word")
+_$insert(_el$2,message)
+_$effect((_$p)=>_$setProp(_el$2,"fg",props.api.theme.current.error,_$p))
+return _el$2
+})()
+}),null)
+return _el$
+}})
+}
 function TodoSection(props){const list=createMemo17(()=>props.controller.list(props.sessionID))
 const icons=useIcons()
 const unavailable=()=>hostCapabilityUnavailable(props.api,"todo")
-const [mode,setMode]=createSignal26("all")
+const managed=()=>("guidance" in props.controller)?props.controller:undefined
+const [mode,setMode]=createSignal27("all")
 const targetKey=createMemo17(()=>props.controller.target?.(props.sessionID).key??props.sessionID)
 createEffect15(()=>{targetKey()
 setMode("all")
@@ -6735,28 +6859,48 @@ return _$createComponent(Section,{get api(){return props.api
 },sectionId:`${PLUGIN_ID}.section.todo`,get navigationSection(){return navigationSection()
 },title:"TODO",section:"todo",get summary(){return _$memo(()=>!!unavailable())()?"\u2014":`${view().counts.completed}/${list().length}`
 },get open(){return props.preferences.expanded().todo
-},onToggle:()=>props.preferences.toggleSectionExpanded("todo"),get children(){return _$createComponent(Show22,{get when(){return unavailable()
-},get fallback(){return _$createComponent(SectionRequestBody,{get api(){return props.api
+},onToggle:()=>props.preferences.toggleSectionExpanded("todo"),get children(){return _$createComponent(Show23,{get when(){return unavailable()
+},get fallback(){return(()=>{var _el$=_$createElement("box")
+_$setProp(_el$,"gap",1)
+_$insert(_el$,_$createComponent(Show23,{get when(){return managed()?.guidance(props.sessionID).available
+},get children(){return _$createComponent(TodoGuidanceControl,{get api(){return props.api
+},get controller(){return managed()
+},get sessionID(){return props.sessionID
+},get interaction(){return props.interaction
+},get navigationSection(){return navigationSection()
+}})
+}}),null)
+_$insert(_el$,_$createComponent(Show23,{get when(){return _$memo(()=>!!(managed()&&state().error))()&&!managed()?.guidance(props.sessionID).available
+},get children(){var _el$2=_$createElement("text")
+_$insertNode(_el$2,_$createTextNode(`Add Navigator's server plugin to opencode.json; restart OpenCode to enable Todo.`))
+_$setProp(_el$2,"wrapMode","word")
+_$effect((_$p)=>_$setProp(_el$2,"fg",props.api.theme.current.textMuted,_$p))
+return _el$2
+}}),null)
+_$insert(_el$,_$createComponent(SectionRequestBody,{get api(){return props.api
 },get interaction(){return props.interaction
 },id:`${PLUGIN_ID}.retry.todo`,get position(){return{section:navigationSection(),row:1,column:0
 }},get state(){return state()
 },get hasItems(){return list().length>0
-},empty:"No tasks yet",loading:"Loading tasks\u2026",onRetry:()=>void props.controller.retry(props.sessionID),get children(){return _$createComponent(TodoContents,{get api(){return props.api
+},empty:"No tasks yet",loading:"Loading tasks\u2026",onRetry:()=>void props.controller.retry(props.sessionID).catch(()=>{}),get children(){return _$createComponent(TodoContents,{get api(){return props.api
 },get interaction(){return props.interaction
 },get navigationSection(){return props.navigationSection
 },get mode(){return mode()
 },setMode,get view(){return view()
 },visibility,get density(){return props.preferences.rowDensity?.()??"compact"
+},get managed(){return Boolean(managed())
 }})
-}})
-},children:(message)=>(()=>{var _el$=_$createElement("text"),_el$2=_$createTextNode(` `)
-_$insertNode(_el$,_el$2)
-_$setProp(_el$,"wrapMode","word")
-_$insert(_el$,()=>icons.icon("info"),_el$2)
-_$insert(_el$,message,null)
-_$effect((_$p)=>_$setProp(_el$,"fg",props.api.theme.current.textMuted,_$p))
+}}),null)
 return _el$
 })()
+},children:(message)=>(()=>{var _el$4=_$createElement("text"),_el$5=_$createTextNode(` `)
+_$insertNode(_el$4,_el$5)
+_$setProp(_el$4,"wrapMode","word")
+_$insert(_el$4,()=>icons.icon("info"),_el$5)
+_$insert(_el$4,message,null)
+_$effect((_$p)=>_$setProp(_el$4,"fg",props.api.theme.current.textMuted,_$p))
+return _el$4
+})()
 })
 }})
 }
@@ -6868,7 +7012,7 @@ _$setProp(_el$2,"flexDirection","row")
 _$setProp(_el$2,"justifyContent","space-between")
 _$setProp(_el$2,"gap",1)
 _$setProp(_el$3,"flexGrow",1)
-_$insert(_el$3,_$createComponent(Show23,{get when(){return props.preferences.showSessionTitle()
+_$insert(_el$3,_$createComponent(Show24,{get when(){return props.preferences.showSessionTitle()
 },get children(){var _el$4=_$createElement("text"),_el$5=_$createElement("b")
 _$insertNode(_el$4,_el$5)
 _$setProp(_el$4,"wrapMode","word")
@@ -6876,7 +7020,7 @@ _$insert(_el$5,()=>props.title)
 _$effect((_$p)=>_$setProp(_el$4,"fg",theme().text,_$p))
 return _el$4
 }}),null)
-_$insert(_el$3,_$createComponent(Show23,{get when(){return _$memo(()=>!!props.preferences.showSessionDate())()&&created()
+_$insert(_el$3,_$createComponent(Show24,{get when(){return _$memo(()=>!!props.preferences.showSessionDate())()&&created()
 },children:(value)=>(()=>{var _el$6=_$createElement("text")
 _$insert(_el$6,value)
 _$effect((_$p)=>_$setProp(_el$6,"fg",theme().textMuted,_$p))
@@ -7007,7 +7151,7 @@ return false
 }
 function enabled(value){return typeof value==="function"?value():value!==false
 }
-function createV2Keymap(context){const [revision,setRevision]=createSignal27(0)
+function createV2Keymap(context){const [revision,setRevision]=createSignal28(0)
 const layers=new Map
 let sequence=0
 function layerActive(layer){const mode=layer.mode??"base"
@@ -7191,8 +7335,8 @@ context.ui.router.navigate({type:"plugin",name,data:params})
 },attention:context.attention,lifecycle:{signal:controller.signal,onDispose}}
 api.slots=createV2Slots(context,keymap,(dispose)=>{onDispose(dispose)
 })
-setHostCapabilities(api,{todo:true,lsp:false,titleVisibility:false,unavailable:{todo:"OpenCode 2 does not expose Todo data through its supported plugin API."
-}})
+setHostCapabilities(api,{todo:true,lsp:false,titleVisibility:false
+})
 return{api,async dispose(){controller.abort()
 for(let index=disposers.length-1;index>=0; index--)
 await disposers[index]()
@@ -7264,9 +7408,9 @@ if(item.source.target.startsWith("."))
 throw new Error("Unrecognized local Navigator source")
 await context.client.plugin.update({location:response.location,targets:[item.source.target]})
 }}}
-async function setupNavigator(api,options,readProject){const config=pluginConfig(undefined)
+async function setupNavigator(api,options,readProject,managedTodo){const config=pluginConfig(undefined)
 const configured=await loadConfiguredDefaults(api,options,readProject)
-const todo=createTodoController(api)
+const todo=managedTodo??createTodoController(api)
 const subagents=createSubagentController(api)
 const skills=createSkillController(api)
 const preferences=createPreferencesController(api,config,createPreferencesStore(api.state.path.state),configured)
@@ -7293,7 +7437,7 @@ api.slots.register({order:100,slots:{app(){return _$createComponent(IconProvider
 },interaction,skills,subagents,mcp
 }),_$createComponent(FirstRunWizardPersistence,{api,preferences
 }),_$createComponent(StartupSessionBinding,{api,controller:startup
-}),_$createComponent(UpgradeNotesBinding,{api,preferences,version:"0.17.3"
+}),_$createComponent(UpgradeNotesBinding,{api,preferences,version:"0.18.0"
 }),_$createComponent(McpPersistence,{api,controller:mcp
 })]
 }})
@@ -7323,33 +7467,34 @@ throw result.error
 }
 return result.data?.type==="text"?result.data.content:undefined
 })
-const versionStatus=createVersionStatus(api,"0.17.3")
-const versionUpdates=createVersionUpdateActions(api,versionStatus,createOpenCodeV1VersionUpdater(api,meta),()=>preferences.rememberNavigatorVersionBeforeUpdate("0.17.3"))
+const versionStatus=createVersionStatus(api,"0.18.0")
+const versionUpdates=createVersionUpdateActions(api,versionStatus,createOpenCodeV1VersionUpdater(api,meta),()=>preferences.rememberNavigatorVersionBeforeUpdate("0.18.0"))
 api.slots.register({order:90,slots:{sidebar_footer(_context,props){return _$createComponent(IconProvider,{get style(){return preferences.lspIconStyle
 },get multilineCorners(){return preferences.cornerFont
 },get children(){return _$createComponent(VersionFooter,{api,get sessionID(){return props.session_id
-},navigatorVersion:"0.17.3",status:versionStatus,get onOpenCodeUpdate(){return versionUpdates.openCode
+},navigatorVersion:"0.18.0",status:versionStatus,get onOpenCodeUpdate(){return versionUpdates.openCode
 },get onNavigatorUpdate(){return versionUpdates.navigator
 }})
 }})
 }}})
 }
 var setupOpenCodeV2=async (context)=>{const adapter=createOpenCodeV2Api(context)
+const todo=createNavigatorTodoController(context,adapter.api)
 const{mcp,preferences
 }=await setupNavigator(adapter.api,context.options,async ()=>{if(!context.client.file?.read)
 return
 return new TextDecoder().decode(await context.client.file.read({location:context.location,path:".opencode/navigator.json"
 }))
-})
-const versionStatus=createVersionStatus(adapter.api,"0.17.3")
-const versionUpdates=createVersionUpdateActions(adapter.api,versionStatus,createOpenCodeV2VersionUpdater(context),()=>preferences.rememberNavigatorVersionBeforeUpdate("0.17.3"))
+},todo)
+const versionStatus=createVersionStatus(adapter.api,"0.18.0")
+const versionUpdates=createVersionUpdateActions(adapter.api,versionStatus,createOpenCodeV2VersionUpdater(context),()=>preferences.rememberNavigatorVersionBeforeUpdate("0.18.0"))
 const disposeFooter=context.ui.slot({append:"sidebar.footer",render:()=>_$createComponent(IconProvider,{get style(){return preferences.lspIconStyle
 },get multilineCorners(){return preferences.cornerFont
 },get children(){var _el$=_$createElement("box")
 _$setProp(_el$,"flexDirection","row")
 _$setProp(_el$,"justifyContent","space-between")
 _$insert(_el$,_$createComponent(VersionSummary,{get api(){return adapter.api
-},navigatorVersion:"0.17.3",status:versionStatus,get onOpenCodeUpdate(){return versionUpdates.openCode
+},navigatorVersion:"0.18.0",status:versionStatus,get onOpenCodeUpdate(){return versionUpdates.openCode
 },get onNavigatorUpdate(){return versionUpdates.navigator
 }}),null)
 _$insert(_el$,_$createComponent(SettingsFooterButton,{get api(){return adapter.api

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-navigator",
-  "version": "0.17.3",
+  "version": "0.18.0",
   "description": "Search, navigate, and manage OpenCode sessions from the TUI",
   "type": "module",
   "packageManager": "bun@1.4.2",
@@ -27,6 +27,8 @@
   ],
   "files": [
     "dist",
+    "server.js",
+    "rpc.js",
     "assets",
     "scripts/install-font.mjs",
     "scripts/update-local-snapshot.mjs",
@@ -40,6 +42,12 @@
   "exports": {
     "./tui": {
       "import": "./dist/tui.js"
+    },
+    "./server": {
+      "import": "./dist/server.js"
+    },
+    "./rpc": {
+      "import": "./dist/rpc.js"
     }
   },
   "publishConfig": {

package/rpc.js

@@ -0,0 +1 @@
+export { NavigatorTodoRpc } from './dist/rpc.js'

package/server.js

@@ -0,0 +1 @@
+export { default } from './dist/server.js'