Practical guide · capabilities and examples

What you can ask Metnos to do

Capabilities are grouped by area, called a domain in the Metnos code. Each example is a sentence you can use in chat: no operation names or special syntax are required.

29areas120documented operations

This guide follows the 29 areas defined in the code. Its operation lists are generated from technical descriptions, called manifests, and the functions built into Metnos. A documented capability may require services, credentials, or permissions that your installation does not have. It must also pass Executor Birth checks before use. Installed skills can add services and operations. Ask the Tutor what is available on your instance.

Content and computationResult compositionCommunication and timeWeb, places, and mediaCollaboration and providersControl and administrationCross-domain utilities
05

Content and computation

Files, structures, and local transformations.

files

Files

21 documented operations

Finds, reads, creates, converts, moves, shares, and analyses local files or files supplied by a provider. This includes documents, spreadsheets, PDFs, OCR, archives, hashes, and lines of code.

Limits. This domain concerns the file container. Use Images for the visual meaning of a photo and URLs for a public web page.

For example, write in chat:“Find every PDF changed this week in Projects and summarise the ones about Atlas.”

For example, write in chat:“Find image files with identical content in the server's Pictures folder and tell me how much space the redundant copies use.”

Included operations (21)
change_files_formatcompress_filescompute_files_loccreate_files_doccreate_files_spreadsheetdelete_filesfind_filesfind_files_hashget_filesmove_filesorganize_filesread_filesread_files_csvread_files_docread_files_ocrread_files_spreadsheetread_files_xlsxshare_fileswrite_fileswrite_files_docwrite_files_spreadsheet
dirs

Folders

4 documented operations

Lists, finds, creates, and deletes directories, including on a remote device when the plan requires it.

Limits. A folder organises files; it does not represent their content. Unsafe deletion remains subject to the normal gates.

For example, write in chat:“Show the subfolders under Photos ordered by size.”

For example, write in chat:“Create the Clients/2026 folder on the office laptop.”

Included operations (4)
create_dirsdelete_dirsfind_dirslist_dirs
packages

Installed programs

2 documented operations

Checks whether an executable command or program is available in the selected system PATH.

Limits. It detects availability and location; it does not automatically install unrequested packages.

For example, write in chat:“Check whether ffmpeg is installed on this server.”

For example, write in chat:“Where is python3 on the paired Windows PC?”

Included operations (2)
find_packagesinstall_packages
numbers

Numbers

1 documented operation

Computes descriptive statistics over numeric values: count, minimum, maximum, mean, and other admitted summaries.

Limits. It receives explicit numbers or values produced by a previous step; it is not a persistent spreadsheet.

For example, write in chat:“Compute the mean, minimum, and maximum of 12, 18, 21, 21, and 34.”

For example, write in chat:“Find this month's invoices and tell me the average spend.”

Included operations (1)
describe_numbers
texts

Texts

1 documented operation

Filters and transforms text already available, at granularities such as lines, paragraphs, or segments.

Limits. It works on in-memory text; extracting it first from a file, message, or page requires the corresponding source domain.

For example, write in chat:“From the log I gave you, keep only lines containing timeout or retry.”

For example, write in chat:“Read the document and show only the paragraphs containing a date.”

Included operations (1)
filter_texts_lines
02

Result composition

Internal steps joining several capabilities in one request.

entries

In-memory results

11 documented operations

Sorts, filters, groups, classifies, compares, extracts, and summarises structured rows produced during the same turn.

Limits. This is an internal composition domain: people describe the desired result and do not need to know the name entries.

For example, write in chat:“Find July's invoices, group them by supplier, and order them from most expensive.”

For example, write in chat:“Find open issues, classify them by urgency, and show only critical ones.”

Included operations (11)
classify_entriescompare_entriescompute_entriesdelete_entriesdescribe_entriesextract_entriesfilter_entriesfind_entriesgroup_entriessort_entrieswrite_entries
lists

List comparison

1 documented operation

Compares two result sets to find common, new, or missing items using explicit keys.

Limits. Lists must come from the same plan or an identifiable source; comparison does not invent matches.

For example, write in chat:“Compare the files in these two folders and show those present only in the second.”

For example, write in chat:“Which issues are new compared with yesterday's saved list?”

Included operations (1)
filter_lists
05

Communication and time

Messages, address books, calendars, and future activities.

messages

Messages and mail

4 documented operations

Finds, reads, sends, replies to, labels, moves, or deletes messages through configured accounts, including IMAP/SMTP, Gmail, and admitted channels.

Limits. The account can be selected when several exist. Sending, replying, and deleting retain consent and traceability.

For example, write in chat:“Using my work account, find Marta's messages from the last seven days with PDF attachments.”

For example, write in chat:“Reply in the same thread that the meeting is confirmed, but show me the text first.”

Included operations (4)
move_messagesread_messagessend_messagesset_messages
events

Events

4 documented operations

Reads, creates, and deletes appointments and finds free intervals in accessible calendars.

Limits. An event is an appointment. Calendars manages containers; Scheduled tasks executes requests in the future.

For example, write in chat:“Find a free hour on Tuesday afternoon across my calendar and Anna's.”

For example, write in chat:“Create a 45-minute meeting with Luca on Friday at 10.”

Included operations (4)
create_eventsdelete_eventsfind_events_emptyread_events
contacts

Contacts

2 documented operations

Finds and reads address-book records containing names, email addresses, and phone numbers, locally or from a connected account.

Limits. A contact is an address-book record. Persons instead represents local identities and recognition in photos.

For example, write in chat:“Find Laura Bianchi's email address in my contacts.”

For example, write in chat:“Show the phone number for the Acme Support contact.”

Included operations (2)
find_contactsread_contacts
tasks

Scheduled tasks

6 documented operations

Creates, reads, changes, and deletes reminders or recurring requests and retains execution history. It covers only the internal Metnos scheduler.

Limits. A task executes a request at a time or trigger; it is neither a calendar appointment nor a remote automation, which belongs to Remote automations.

For example, write in chat:“Every Monday at 8, read unread mail from my work account and send me a summary on Telegram.”

For example, write in chat:“Show the latest outcomes of the Photo backup task and any errors.”

Included operations (6)
create_tasksdelete_taskslist_tasksread_tasksread_tasks_historyset_tasks
calendars

Calendars

2 documented operations

Creates and removes calendar containers, distinct from the appointments they contain.

Limits. Deleting a calendar may also delete its events and is therefore a destructive gated operation.

For example, write in chat:“Create a new Google calendar named Support shifts.”

For example, write in chat:“Delete the Test 2025 trial calendar and all its contents.”

Included operations (2)
create_calendarsdelete_calendars
05

Web, places, and media

Public information, web sessions, and visual archives.

places

Places

2 documented operations

Finds real-world places from text or coordinates and converts GPS coordinates into geographic names.

Limits. The user's current location is a separate system utility; Places interprets or searches destinations.

For example, write in chat:“Find a pharmacy near Piazza Maggiore in Bologna.”

For example, write in chat:“Which place corresponds to coordinates 45.4642, 9.1900?”

Included operations (2)
find_placesget_places
urls

Web and URLs

5 documented operations

Searches the web, fetches known URLs, and reads public HTML pages or PDFs, extracting text and metadata.

Limits. A public page without session state belongs to URLs. Use Sites for an authenticated, interactive website.

For example, write in chat:“Search the web for the latest European guidance on digital product passports and cite the sources.”

For example, write in chat:“Read this online PDF and summarise requirements, deadlines, and intended audiences.”

Included operations (5)
find_urlsget_urlslogin_urlsread_urls_htmlread_urls_pdf
images

Images and photographs

9 documented operations

Describes images, builds and queries local indexes, searches by content, person, or similarity, searches web images, and accesses Google photos created through Metnos.

Limits. Generic path operations remain in Files. Google Photos exposes only items allowed by its API and mandate.

For example, write in chat:“In the photo archive, find images of Carlo by the sea at sunset.”

For example, write in chat:“Search the web for a reusable aerial photograph of Milan Cathedral.”

Included operations (9)
create_images_indicesdelete_images_indicesdescribe_imagesfind_images_google_photosfind_images_indicesfind_images_webget_images_google_photosget_images_indiceswrite_images_google_photos
persons

People and local identities

5 documented operations

Manages a local named-person registry and links recognised faces to people in photographs; it can also read the current actor's profile.

Limits. It is not an address book: email addresses and phone numbers belong to Contacts. Biometric data and deletion have dedicated controls.

For example, write in chat:“Register this photo as Francesca Riva's face.”

For example, write in chat:“Find every archive photo containing Francesca.”

Included operations (5)
delete_personsfind_persons_indicesget_personsread_personsset_persons
sites

Stateful sites

5 documented operations

Opens a persistent browser session, reaches login using protected credentials, reads page state, and performs narrow-mandate web actions.

During collection, it can return directly to a previously reached page and verify its content and context before continuing. If verification fails, it follows the previous path again within the session limits.

For invoices from one specific year, reaching an earlier year can stop the search within the same list when its dates and order can be verified. Details of the requested invoices still need to be read. Views of the same document can be merged using the observed link to its detail; equal dates and amounts alone do not prove a duplicate. Verifying written rows does not certify archive completeness.

Limits. Credentials are injected by the broker and never shown to the model. Sensitive actions require confirmation.

For example, write in chat:“Sign in to the courier portal and tell me where shipment 12345 is.”

For example, write in chat:“Open the bank website, download June's statement, and stop before making any transaction.”

Included operations (5)
act_sitesdelete_siteslogin_sitesopen_sitesread_sites
05

Collaboration and providers

Extensions and shared work objects.

workflows

Remote automations

2 documented operations

Starts automations already present in a repository and lists their runs with outcome, branch, and duration.

Limits. It is distinct from scheduled tasks, which are the internal Metnos scheduler, and from processes, which are software running on a machine.

For example, write in chat:“Start the ci.yml automation of acme/app on the main branch.”

For example, write in chat:“Show the latest failed automation runs of acme/app.”

Included operations (2)
find_workflowsrun_workflows
issues

Issues

5 documented operations

Through a provider skill, finds, reads, creates, updates, or closes project issues with state, labels, and assignees.

Limits. The currently documented provider is GitHub and requires configured credentials; effective capabilities depend on the skills admitted by the instance.

For example, write in chat:“In the metnos repository, find open issues labelled bug created in the last week.”

For example, write in chat:“Create an issue in acme/app with this title and assign it to the release owner.”

Included operations (5)
create_issuesdelete_issuesfind_issuesread_issuesset_issues
pulls

Pull requests

4 documented operations

Finds and reads pull requests, diffs, and review state; updates or merges a request when the provider and mandate allow it.

Limits. It is distinct from issues because it includes code changes, reviews, and merge. Mutating operations are gated.

For example, write in chat:“Show open pull requests in acme/app that modify the security folder.”

For example, write in chat:“Read PR 42's diff, summarise the risks, and stop before merge.”

Included operations (4)
change_pullsfind_pullsread_pullsset_pulls
comments

Comments

2 documented operations

Writes and deletes comments on a provider's discussion items: issues and pull requests.

Limits. A comment is not mail: it has no recipient, folder, or delivery. Approving or requesting changes on a pull request is a verdict instead, and belongs to Pull requests.

For example, write in chat:“On issue 42 of acme/app, write that the problem also shows on the new version.”

For example, write in chat:“Delete the comment I left by mistake on pull request 7.”

Included operations (2)
create_commentsdelete_comments
skills

Skills

2 documented operations

Lists and manages installed extensions that can add executors, providers, and specialised knowledge to the local catalog.

Limits. A skill is admitted through verification and policy; installing one does not bypass vocabulary, sandboxing, or consent.

For example, write in chat:“Which skills are installed and which are enabled?”

For example, write in chat:“Enable the already installed GitHub skill and show which capabilities it adds.”

Included operations (2)
list_skillsset_skills
07

Control and administration

Observability, consent, security, and configuration.

processes

Processes and system health

3 documented operations

Obtains a snapshot of processes and system-health signals on the local system or an eligible device.

Limits. This is observation, not arbitrary shell administration: available actions remain those of admitted executors.

For example, write in chat:“Which processes are using the most memory on this server?”

For example, write in chat:“Check the office PC's health and show any anomalous processes.”

Included operations (3)
get_processesrun_processesset_processes
signatures

Security signatures

3 documented operations

Computes, reads, and curates canonical signatures used to classify system commands and actions into allowed, uncertain, or forbidden policy sets.

Limits. This is an administrative security domain, not cryptographic signing of user documents.

For example, write in chat:“Show the signatures currently on the greylist and their classification.”

For example, write in chat:“Compute the canonical signature of the proposed command without executing it.”

Included operations (3)
compute_signaturesget_signaturesset_signatures
proposals

Evolution proposals

1 documented operation

Exposes local proposals awaiting review. The current nightly producer proposes deduplication; generalisation and specialisation remain readable only in historical records.

Limits. Reading a proposal does not approve it. Acceptance, rejection, and rollback occur through the designated administrative surfaces.

For example, write in chat:“Show the deduplication proposals still awaiting review.”

For example, write in chat:“Explain this proposal, its risks, and how to reach the page where I can approve it.”

Included operations (1)
get_proposals
inputs

Structured input

1 documented operation

Collects missing information in typed dialogs and forms, including choices, dates, files, and sensitive fields.

Limits. It is an interaction capability used inside an operation; people normally do not invoke it by name.

For example, write in chat:“Prepare a new mailbox and ask me for the missing server, port, and username in a form.”

For example, write in chat:“Create the event; if you do not know which calendar to use, let me choose from those available.”

Included operations (1)
get_inputs
approval

Human approval

1 documented operation

Presents an Approve/Reject choice and continues along the allowed branch while preserving preview, actor, and traceability.

Limits. It is a gate, not a shortcut: approval does not expand executor authority or make a forbidden action permissible.

For example, write in chat:“Prepare deletion of duplicate files, show me the list, and ask for approval before proceeding.”

For example, write in chat:“If the quote exceeds 500 euros, stop and ask for my confirmation.”

Included operations (1)
get_approval
credentials

Credentials

3 documented operations

Configures, lists by metadata, and deletes encrypted bindings for mailboxes, APIs, cloud services, and authenticated sites.

Limits. Clear-text secrets never return to the planner or Tutor. Multiple accounts of the same type remain selectable through distinct bindings.

For example, write in chat:“Configure a second IMAP mailbox named personal and ask me for credentials securely.”

For example, write in chat:“Which email accounts and cloud providers are configured, without showing any secret?”

Included operations (3)
delete_credentialsfind_credentialsset_credentials
preferences

Personal preferences

3 documented operations

Lists, sets, and removes the preferences with which a user decides how Metnos behaves towards them: reply length and tone, units, language, browser mode.

Limits. Keys and values form a closed vocabulary, and each person sees only their own preferences. A preference that is recorded but not yet applied by any answer path is declared as such.

For example, write in chat:“Which preferences have I set?”

For example, write in chat:“From now on, answer me concisely.”

Included operations (3)
delete_preferencesget_preferencesset_preferences
01

Cross-domain utilities

Primitives assisting several domains.

_system

Cross-domain utilities

5 documented operations

Provides reliable date and time, the last observed location, undo for the latest reversible turn, and expert consultation when admitted.

Limits. These are cross-domain primitives, not new data domains. Undo operates only on effects with a recorded compensation.

For example, write in chat:“What time is it in Tokyo right now?”

For example, write in chat:“Undo the reversible operations from my last turn.”

Included operations (5)
consult_frontierget_locationget_nowstart_lreundo_last_turn

Connected services and availability

The same area can use different services. Email, for example, may use an IMAP/SMTP mailbox or Google Workspace; files may be local or stored in a connected service. Credentials, skills, and permissions determine which connections are available. When an operation lets you choose a provider, that choice is a request parameter: each service does not need a separate command. The Tutor checks your instance’s current catalog before explaining what you can use.