assistant

package
v0.6.173 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 22, 2026 License: MIT, MIT Imports: 2 Imported by: 0

README

The Assistant

The Assistant is a personal assistant that keeps its conversation with you across sessions. It runs on your computer as a persistent agent: you start it, talk to it, stop it, and when you start it again the conversation continues.

This is the package that runs

The Assistant is built into the Agentry CLI and the desktop app, and it runs from there: agentry agent start assistant, then agentry agent chat assistant, in the CLI. This release has the same bytes. The registry built its archive from the package the CLI carries, and the archive's digest is the one the CLI reports. Run agentry builtins to print it and compare it with the digest on this page.

Installing this release does not give you the Assistant. A persistent release runs only as a built-in, so the application runs it, with what is listed below; the runner refuses to run this release as an ordinary QuickAgent.

What the application gives it

The manifest declares no network access, no file access, no commands and no secret. When the application runs the Assistant, it gives it what follows, and agentry agent show assistant lists what it has:

  • Its conversation is kept on a volume of the agent's own, which the runner keeps between starts and removes only when you reset the agent (agentry agent reset assistant).
  • Its own files are on a second volume, its data folder, kept the same way.
  • Its memory is on a third volume, kept the same way: a wiki it writes in memory/, with pages on what you tell it and what you share with it, each fact with its source (a file in your share and the date it read it, or what you said and when), an index and a log. It is told never to change your share's files to keep it. When the memory is made, the notes in its data folder's notes/ are copied into it, and stay where they are. agentry agent memory export assistant <folder> copies the memory into a new folder, readable by you alone; a reset removes it.
  • Three skills of its own, on unless you switch them off: memory-ingest, memory-query and memory-lint, which say how it adds to its memory, answers from it and checks it.
  • A share folder of yours, ~/agentry/assistantshare unless you choose another, is mounted read and write while it runs: you see what it writes there as it writes it. A file you add is checked for malware with ClamAV before it reads it, and one ClamAV finds is not read; a file the check cannot read (no signatures on your computer, or past its size limits) is read unchecked, and the segment's receipts say so. You can switch the share off.
  • What you add: knowledge packs from your computer and MCP servers, each an entry of its roster that you switch on and off. Adding one, or turning on one you have not agreed to on this computer, asks you first.
  • A name and a personality, when you give them, reach it at its next message. On its first conversation it asks you for both, and saves your answer through its Agentry tool self_configure, which changes its name and personality and nothing else.
  • The time: each message it is sent starts with the time now and your time zone.
  • Tasks and a heartbeat. When you ask it to do something at a time, it registers a task through its Agentry tools (task_add, task_list, task_update, task_remove): a name, a cron time and an instruction to itself. While it runs and its roster's heartbeat entry is on (off until you switch it on), its heartbeat fires each task as a message of its own at its time, which uses your model plan. A task due while it was stopped does not run: it is told at its next message. At most 25 tasks, none more often than every 15 minutes and 96 fires a day in all. agentry agent tasks assistant lists them, and pauses, resumes or removes one. A task gives it nothing it does not already have.
  • Each start is a segment, with its own receipts and result envelope in the agent's folder under the runner home, and the conversation's record continues across segments.
  • It runs without the session caps an interactive QuickAgent has: no idle timeout, no time limit and no turn limit. You stop it.
  • It runs on the harness and model your runner policy names, in a container, with the same sandbox every run has: no route out but the model's.

Using Agentry: https://docs.secureagentry.net/

Documentation

Overview

Package assistant is the Assistant: the built-in persistent agent that is the person's own assistant, embedded in the CLI and run by the runner as a persistent agent (pkg/runner/persistent). Its manifest declares the persistent run mode alone, no egress, no filesystem, no exec and no secret; the runner keeps its conversation on a volume of its own between segments, tells it the time at each turn, fires the tasks it registers, keeps its memory on a third volume seeded from memory/, and gives it its folders, its skills (skills/) and what its roster has on.

Index

Constants

View Source
const (
	Namespace = "agentry"
	Name      = "assistant"
	Version   = "1.4.0"
)

The package's identity, as its manifest declares it.

Variables

This section is empty.

Functions

func FS

func FS() fs.FS

FS is the package's tree: agent.yaml, INSTRUCTION.md, README.md and LICENSE at its root, the memory's seed beneath memory/ and its skills beneath skills/.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL