NanumOS

Developer guide

NanumOS apps offer what a person can click as "actions" too. The assistant drives apps through them; deleting or sending happens only after [Allow] on screen.

SDK and app kit Planned

The app-building kit is not published yet. When it is, this chapter will say where to get it and how to use it.

App actions

The actions the assistant can call in each app. Actions marked * always need a person's [Allow]. Apps with "state" tell the assistant about the open document or folder.

AppActionsState
Filesfile_reveal files.open files.mkdir files.new_file files.copy files.move* files.rename* files.trash* files.undo files.send_to_mac* files.verify_signature files.decrypt* files.compress files.extractyes
Mailmail.open mail.search mail.read mail.draft mail.reply mail.send* mail.delete*yes
Newsnews_save news.subscribe news.unsubscribe* news.refresh news.headlinesyes
Zeus Radioradio_play radio_stopno
Notepadnote_append note_change note_add notes.open notes.new notes.delete* notes.append notes.summarize notes.rewrite notes.translate notes.continueyes
Calendarcalendar_add calendar_note calendar.goto calendar.add calendar.move* calendar.delete*yes
Settingssettings.open settings.show settings.set*yes
Clockclock.alarm_add clock.alarm_delete* clock.timer_start clock.timer_cancelyes
Virtual Machinesvm_list vm_create vm_controlno
Remindersreminder_addno
Photosphotos.open photos.next photos.prev photos.grid photos.trash* photos.pick_bestyes
Musicmusic.play music.queue music.pause music.next music.stopyes
zOffice Sheetsheet_create sheet.new sheet.open sheet.set sheet.replace* sheet.sum sheet.saveyes
zOffice Documentsdoc_create doc_edit documents.new documents.open documents.set_title* documents.appendyes
Video Retouchvideo_edit videoedit.import videoedit.trim videoedit.exportyes
Photo Retouchretouch.open retouch.close retouch.open_sample retouch.apply_preset retouch.sync_edit* retouch.batch_export retouch.watermark* retouch.crop retouch.resize retouch.rotate retouch.add_text retouch.layer_new retouch.layer_dup retouch.layer_delete* retouch.layer_show retouch.layer_hide retouch.remove_object retouch.blemish retouch.undo retouch.redo retouch.save* retouch.save_desktop retouch.batch retouch.exportyes

Plugins

One connected service is one plugin in one folder. Its plugin.toml states the name, permissions and tools. A manifest that breaks a rule is not listed.

keymeaning
name title title_ko description description_ko version license iconwhat Settings shows; license is the server program's
vaultthe vault entry with the login: **계정/<name>** by default (계정/github, 계정/telegram, 계정/reddit, 계정/discord, 계정/naver-dev, 계정/gmail …)
settingsfields the login form shows (url)
[permissions] read write hostsin words for the consent sheet; hosts is enforced (a request elsewhere is refused before the broker is asked)
[[tools]] name as kind brief args item_* description args_docthe MCP tool names the assistant may use (kind = read|write; a write tool needs permissions.write); brief = true = part of every check and the briefing; item_id/title/from/kind/when = JSON paths that turn a remote tool's list into briefing items

Manual chapters

NanumOS 0.1.8349 · 2026-11-16