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.
| App | Actions | State |
|---|---|---|
| Files | file_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.extract | yes |
mail.open mail.search mail.read mail.draft mail.reply mail.send* mail.delete* | yes | |
| News | news_save news.subscribe news.unsubscribe* news.refresh news.headlines | yes |
| Zeus Radio | radio_play radio_stop | no |
| Notepad | note_append note_change note_add notes.open notes.new notes.delete* notes.append notes.summarize notes.rewrite notes.translate notes.continue | yes |
| Calendar | calendar_add calendar_note calendar.goto calendar.add calendar.move* calendar.delete* | yes |
| Settings | settings.open settings.show settings.set* | yes |
| Clock | clock.alarm_add clock.alarm_delete* clock.timer_start clock.timer_cancel | yes |
| Virtual Machines | vm_list vm_create vm_control | no |
| Reminders | reminder_add | no |
| Photos | photos.open photos.next photos.prev photos.grid photos.trash* photos.pick_best | yes |
| Music | music.play music.queue music.pause music.next music.stop | yes |
| zOffice Sheet | sheet_create sheet.new sheet.open sheet.set sheet.replace* sheet.sum sheet.save | yes |
| zOffice Documents | doc_create doc_edit documents.new documents.open documents.set_title* documents.append | yes |
| Video Retouch | video_edit videoedit.import videoedit.trim videoedit.export | yes |
| Photo Retouch | retouch.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.export | yes |
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.
| key | meaning |
|---|---|
name title title_ko description description_ko version license icon | what Settings shows; license is the server program's |
vault | the vault entry with the login: **계정/<name>** by default (계정/github, 계정/telegram, 계정/reddit, 계정/discord, 계정/naver-dev, 계정/gmail …) |
settings | fields the login form shows (url) |
[permissions] read write hosts | in 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_doc | the 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
- Connected services (plugins) — Log in to services such as mail, calendars, contacts or GitHub and the assistant (Zeus) checks them and tells you — new mail, today's events, notific…
- Using NanumOS from AI apps (MCP) · a stronger head — Changes are approved on the screen.
- My apps — "make me an app that …" — Tell Zeus something like "make me an app that counts the glasses of water I drink", and the assistant makes a small app just for you and puts it in t…
- Workbench — Workbench in the apps grid opens the console of the Ubuntu VM bench in Virtual Machines, with the keyboard going straight to it.
- Scheduled jobs and services — at a set time, always on — Like a small Linux, NanumOS runs things by itself in two ways.
- The OS improving itself (evolve) — NanumOS can change its own programs for better versions.
NanumOS 0.1.8349 · 2026-11-16