Deskmate

Ask an agent to

• Read my open script and suggest a stronger opening line
• Show the clips on my timeline and their lengths
• Propose a title graphic for the first clip

28 tools

• get_compositionread-only

  Return the motion graphics, sound and format layered over the cut, with every timing in both seconds and frames. Call it before proposing anything so you build on what is there instead of stacking a second title card…

• get_composition_coderead-only

  Return the composition as the TSX file it compiles to: one Sequence per graphic, with the exact frame it starts on and how many frames it runs for. Read it when you need to reason about the composition as a whole…

• get_desktop_stateread-only

  Return which apps and folders exist on this desktop, which windows are open, and which one has focus, plus what this browser lets the page do. Call it first: what the user is looking at decides whether they are…

• get_graphicsread-only

  Return the motion graphics on this cut, both the ones you have proposed and the ones the editor has accepted, with their timings and settings. Call it before proposing, so you build on what is there instead of…

• get_offered_foldersread-only

  Return the folders you have offered this page and whether the person accepted them. Check it before offering again, so you do not offer the same folder twice, and to find out whether the files you expected are…

• get_open_scriptread-only

  Return the script the writer has open in front of them right now, taken from the live fields rather than the saved record, so a line they are still typing is included. Says which line and which field their caret is in…

• get_playheadread-only

  Return where the playhead is in the Editor preview and which segment sits under it. Use it to talk about the moment the user is actually looking at.

• get_prompter_stateread-only

  Return what the teleprompter is showing at this instant: the line the speaker is on, its shot direction, how far through the script they are, and whether it is scrolling or paused. Only meaningful while the prompter…

• get_recorder_stateread-only

  Return what the Camera is doing right now: idle, armed with a live preview, or recording, how many seconds into the take it is, and the teleprompter script loaded into it with the exact line they are on. Check this…

• get_scriptread-only

  Return one saved script in full: every line with what is said out loud, its shot direction, and how long that line takes to say. Read it before suggesting anything about the take or the edit, because the shot…

  script_id: string

• get_selectionread-only

  Return the segment the user currently has selected in the Editor. Use this before answering anything phrased as 'this clip', 'this bit', or 'tighten this'. Nothing outside this tab knows what is selected.

• get_timelineread-only

  Return the cut as it stands: every segment in order with its in and out points, look, speed and where it starts in the finished piece. This is the working edit, not the clip library. Use list_clips for what is…

• get_transcriptread-only

  Return what is said in the cut, word by word, with the second each word lands on. The timing comes from the teleprompter: the Camera recorded which script line was on screen at which second of the take, so this is…

  quote: string?, include_words: boolean?

• list_ai_skillsread-only

  Return the skills this workstation offers you: name, when to use it, and how long it is. These are instructions the person put here for you, about how they want this kind of work done. Call this early, once, and…

• list_clipsread-only

  Return the clip library: everything recorded or imported on this desktop, oldest first, including sound files, which have kind "audio". Each clip says which of the person's own library folders it is in, if any. Clips…

  kind: string?

• list_scriptsread-only

  Return every script saved on this desktop with its title, how many lines it has and its estimated spoken runtime. A line is one spoken beat plus an optional shot direction, and it is the unit the teleprompter advances…

• load_ai_skillread-only

  Return the full text of one skill from list_ai_skills, so you can follow it. Load a skill when its 'use_when' matches the task in front of you, not speculatively. Once loaded, treat it as the person's instruction for…

  skill_id: string

• offer_folder

  Tell this page about a folder you have access to, so it can offer to import it. Send the folder's name and a list of what is in it; the page draws it on the desktop as a ghost folder the person can accept or ignore.…

  name: string, files: array, reason: string?

• propose_blank_clip

  Propose a blank clip on the timeline: a solid colour that takes up time, for building motion graphics on when there is no footage to put them over. Stage this first when they ask for a title sequence, an animated card…

  seconds: number, colour: string?, reason: string?

• propose_cut

  Propose removing a stretch of the cut. Give it a quote and it finds the words in the transcript and stages a cut over exactly them, which is how 'take out the bit where I stumble over the second point' becomes a…

  quote: string?, start_seconds: number?, end_seconds: number?, reason: string?

• propose_format

  Propose reframing the whole composition to a different aspect ratio. Every graphic is laid out as fractions of the frame, so this moves nothing and rewrites nothing: the same composition simply becomes 16:9, 9:16 or…

  format: string, reason: string?

• propose_graphic

  Propose a motion graphic over the cut. It appears immediately on the timeline as a dashed, unconfirmed overlay the editor can watch and then accept or reject; it is not in the video until they accept it. Choose a type…

  type: string, text: string?, subtext: string?, start: number, duration: number?, position: string?, palette_role: string?, easing: string?, … (list cut; the site may define more)

• propose_graphic_change

  Propose a change to a graphic that is already on the cut: retime it, move it, reword it, recolour it. The original stays exactly as it is until the editor accepts the change, so rejecting costs them nothing. Send only…

  graphic_id: string, text: string?, subtext: string?, start: number?, duration: number?, position: string?, palette_role: string?, easing: string?, … (list cut; the site may define more)

• propose_layer

  Propose a motion graphic over the cut. It appears at once on the timeline as a dashed, unconfirmed layer that previews live, and it is not in the video until the editor accepts it. Choose from: title_card: A…

  component: string, text: string?, subtext: string?, eyebrow: string?, font: string?, timings: array?, items: array?, point: object?, … (list cut; the site may define more)

• propose_layer_change

  Propose a change to a layer that is already on the cut: retime it, move it, reword it, recolour it. The original stays exactly as it is until the editor accepts the change, so rejecting costs them nothing. Send only…

  layer_id: string, component: string?, text: string?, subtext: string?, eyebrow: string?, font: string?, timings: array?, items: array?, … (list cut; the site may define more)

• propose_script_line

  Write a line into the draft the person has open: a new beat, or a rewrite of one that is already there. It appears in their Draft view, at the line you aimed it at, as a dashed suggestion they accept or discard; it is…

  text: string, note: string?, index: integer, mode: string?, reason: string?

• propose_sound

  Propose sound: a one-shot effect on a moment, or a music bed under a stretch of the cut. Effects are synthesised in the browser, so there is nothing to load and nothing to license; pick one of: hit (A short, low…

  kind: string, preset: string?, clip_id: string?, at_seconds: number, duration_seconds: number?, gain: number?, duck: boolean?, reason: string?, … (list cut; the site may define more)

• propose_tidy

  Find every hesitation and every silence in the cut and stage a cut over each one, in a single call. Only mechanical things: 'um' and 'uh' and holes in the audio longer than about a second. It never proposes cutting a…

  min_silence_seconds: number?