1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# turbo-python agents.
#
# Each [[agent]] becomes one line of the Agent menu (Alt-A). Choosing it starts
# that program and opens a window on the conversation; closing the window stops
# it again. Open the same agent twice and you get two independent conversations.
#
# The editor is a client for the Agent Client Protocol — https://agentclientprotocol.com —
# so it holds no API key and knows no model. All of that is your agent's own
# configuration, in a file this editor does not read.
#
# name what the menu shows, and what the window is called. Required, and
# unique: a project's agent of the same name replaces one of yours.
# command the program to run. Required. Looked up on PATH.
# args its arguments, passed as given. There is no shell here, so no
# quoting, no globs and no && — use command = "sh", args = ["-c", …]
# when you really want one.
# env extra environment variables. The agent also inherits the ones the
# editor was started with, so a credential already exported reaches
# it without being written down here.
# cwd where to run it, relative to the project. Left out, it is the
# project itself.
#
# A key this file does not define is refused rather than ignored: a misspelt
# `comand` would otherwise look exactly like one that had no effect.
#
# The same file may also live in %[2]s, where it applies to every project you open.
# This one is read afterwards and wins where a name appears in both.
# Docker's agent runtime, talking to a model server of your choosing.
# `docker agent serve acp <file>` speaks the protocol on its standard input and
# output, which is exactly what the editor wants.
#
# The YAML beside this file is the agent's own: which provider, which model,
# which tools. Write it yourself, or run `docker agent new` to start one.
[[agent]]
name = "Local agent"
command = "docker"
args = ["agent", "serve", "acp", "%[1]s/agent.yaml"]
env = { TELEMETRY_ENABLED = "false" }
# A second agent is one more block. Two windows side by side — Window ▸ Tile —
# is how a fast local model and a slow careful one get compared.
#
# [[agent]]
# name = "Reviewer"
# command = "my-agent"
# args = ["--acp", "--profile", "review"]
# cwd = "."
# Once a window is open:
#
# Enter send what you have typed
# Alt-Enter a new line instead of sending
# Tab move between the conversation and the box
# / at the start of the box, list the agent's own commands
# @ list the project's files; the one you pick goes to the agent
# PgUp PgDn read back through the conversation
# Esc stop the turn in progress
# Ctrl-W close the window, and stop the agent with it
#
# And in the conversation, with Tab pressed:
#
# ↑ ↓ move the cursor through what was said
# Shift-↑ ↓ select whole lines
# Ctrl-C copy — the selection, or the block the cursor is on
#
# What is copied goes to this editor's clipboard *and*, through the terminal, to
# the system's — so Shift-Ins pastes it into a file here, and Ctrl-V pastes it
# anywhere else.
#
# Code the agent sends inside a ```python fence is coloured by the same scanner
# this editor colours .py files with. A fence naming a language it does not
# know is left plain rather than guessed at.
#
# An agent with a shell or a filesystem tool asks before it uses one, and the
# box that appears carries the agent's own choices. Nothing runs until you
# answer. When it reads a file you have open and have not saved, it is given
# what you can see rather than what is on disk; when it writes one, the change
# lands in the buffer for you to undo with Ctrl-Z or keep with F2.
|