Devalley 0.21.0

User guide

Welcome your first resident and follow the work and the replies in one place.

Get started

Set up your village and welcome your first resident.

Get startedOverview

At a glance

  • Pick an AI to work with
  • Install and connect it
  • Choose a folder to work in

Get started1/5

Start your village

The Start your village card in the residents panel

Look for Start your village in the residents panel.

Get started2/5

Pick an AI to work with

Antigravity highlighted in the list of agents

Choose an agent, an AI that helps you code, under Pick an agent.

Get started3/5

Install and connect

Install and connect highlighted in step two

Select Install and connect and follow the steps on screen.

Get started4/5

Invite your first resident

Pick a folder and invite highlighted in the final step

Select Pick a folder and invite and choose where you’ll work.

Get started5/5

Pick up where you left off

Show the start guide highlighted in the connection panel

Open Connect agents and select Show the start guide.

Connect your AI

Bring the AI you already work with into your village.

Connect your AIOverview

At a glance

  • Connect an AI you already use
  • Undo a connection
  • Let your AI send letters

Connect your AI1/6

See what’s installed

The Connect agents panel groups tools by installation status

Open Connect agents to see which AI tools are on this computer.

Connect your AI2/6

Connect or disconnect

Disconnect highlighted beside Claude Code

Select Connect to see your AI as a resident when it works. Choose Disconnect to remove it from the village.

Connect your AI3/6

See what your AI can do

Details expanded on the Copilot row

Expand Details to see what your AI can do in the village.

Connect your AI4/6

Get letters from your AI

The button that enables the village tools for Claude Code

Enable the village tools with the highlighted button so your AI can send letters.

Connect your AI5/6

Review a new connection

Undo highlighted on the automatic connection notice

Choose Undo to reverse a connection Devalley made after an update on your Mac.

Connect your AI6/6

Keep talking in the village

The switch that lets Devalley stay in touch with an AI started from a command window

Start your AI from a terminal, a window where you type commands. Turn on this switch to keep chatting in the village.

Explore your village

See what your residents are doing, ask for help, and read their replies.

Your villageOverview

At a glance

  • Open the village from its icon
  • Read letters and check usage
  • Invite and talk to residents

Your village1/9

Open the village menu

Example

  • Devalley 0.21.0
  • Walking residents
  • Village window
  • Open the residents panel
  • Add a project…
  • Connect agents…

Right-click the Devalley icon in your menu bar or taskbar. Choose Open the residents panel to meet your residents.

Your village2/9

Meet residents on your desktop

The village chief on the desktop beneath the Click me · Drag me hint

Turn on Walking residents to see them stroll along the bottom of your desktop.

Your village3/9

Look around the map

A resident’s card open on the village map

Choose Map under Village window and select a resident.

Your village4/9

Read new letters

A letter from Starlight Garden in the inbox

Open Inbox to read your letters.

Your village5/9

See how much is left

Usage bars and reset times for each AI

Open Agent usage to see how much you have left and when it resets.

Your village6/9

Invite a resident

Choose a folder highlighted in the invitation dialog

Open Invite a resident and select Choose a folder….

Your village7/9

Ask and read the reply

A message ready to send in the resident’s conversation

Type a request and select Send. Read the reply right here.

Your village8/9

Start with a suggestion

Explain this project highlighted below the message box

Select Explain this project below the message box to start a conversation.

Your village9/9

Reconnect your window

Connect again highlighted in the command window tab

Reopen your terminal, a window where you type commands. Choose Connect again.

Find shortcuts with a right-click

Open a resident’s menu or work with links and files right from a reply.

Right-click shortcutsOverview

At a glance

  • Pin a resident to the top
  • Copy a link from a reply
  • Find text in a command window

Right-click shortcuts1/8

Open a conversation

Open conversation highlighted in the resident’s menu

Right-click a resident and choose Open conversation.

Right-click shortcuts2/8

Keep a resident at the top

Pin to the top highlighted in the resident’s menu

Choose Pin to the top to keep the resident at the top of your list.

Right-click shortcuts3/8

Save a reply for later

Mark as unread highlighted in the resident’s menu

Choose Mark as unread when you want to come back to a reply.

Right-click shortcuts4/8

Keep a resident in view

Keep out on the desktop highlighted in the resident’s menu

Choose Keep out on the desktop to keep the resident visible there.

Right-click shortcuts5/8

Wrap up a resident’s work

The resident’s menu with Turn its session off highlighted

Choose Turn its session off… to close the resident’s work window when you’re done.

Right-click shortcuts6/8

Copy a link from a reply

Copy link highlighted in the link menu

Right-click the link and choose Copy link.

Right-click shortcuts7/8

Open a file from a reply

Open with default app highlighted in the file menu

Right-click the file and choose Open with default app.

Right-click shortcuts8/8

Find text in the window

Find highlighted in the command window menu

Right-click the terminal, a window where you type commands. Choose Find….

Follow a project

See what’s happening now and catch up on earlier work.

ProjectsOverview

At a glance

  • Open the timeline from the gear
  • Check the work board and costs
  • See wait times and past decisions

Projects1/7

Open the project menu

Timeline highlighted in the project menu

Select the gear beside the project name and choose Timeline.

Projects2/7

Look back at the work

A timeline of resident activity and project history

Open Timeline to see what happened and when.

Projects3/7

Check what’s in progress

The project’s work board with activity grouped by status

Open Work board to see who’s working and who needs your attention.

Projects4/7

Check the cost

The Cost tab with estimates for the selected period

Open Cost and choose a period to see the estimated cost of the work.

Projects5/7

See how long they waited

The Waiting tab with a summary of wait times

Open Waiting to see how long residents waited for you to reply.

Projects6/7

Look up a past decision

The Decisions tab with filters for earlier requests

Open Decisions to see requests you allowed or declined.

Projects7/7

See the skills you can use

The project’s skills list with the AI tools that can use each skill

Open Skills to see the instructions your AI can use again.

Open files

Open files beside the conversation and see what changed.

FilesOverview

At a glance

  • Open code and images
  • Preview documents and videos
  • Review changed files and lines

Files1/7

Open a file and read its code

greeting.js selected in the file list

Select Files above the conversation and choose a file from the list.

Files2/7

Open an image

A PNG preview of the sample garden

Select an image in Files to see it.

Files3/7

Read a PDF

A PDF preview of the sample garden

Choose a PDF in Files to read it alongside the conversation.

Files4/7

Play a video

The sample garden video and its playback controls

Choose a video in Files and press play.

Files5/7

Preview a web page

A preview of the sample web page with Show as code highlighted

Open an HTML file to see the page. Select Show as code to read the code.

Files6/7

Review what changed

The file review with changed lines shaded

Select See this turn’s changes › above the reply to review the changed lines.

Files7/7

Jump from a reply to a file

Open in Code tab highlighted in the file menu

Right-click a file in the reply and choose Open in Code tab.

Set up skills

Save instructions for work you do often and use them again.

SkillsOverview

At a glance

  • Choose which AI can use a skill
  • Pin a skill you use often
  • Save your own instructions

Skills1/5

Browse your skills

The skills available in the example project

Open Skills to see each skill’s name and what it does.

Skills2/5

Turn on a skill

A switch that enables a skill for one AI

Flip the switch beside the skill and select Write to confirm.

Skills3/5

Hide a skill in the village

Hide in Devalley only highlighted on a skill

Select Hide in Devalley only to remove the skill’s button from the village.

Skills4/5

Pin a skill you use often

A pinned skill button below the message box

Select Pin as a button to put the skill below the message box.

Skills5/5

Save your own skill

Add my skill dialog with fields for the name, when to use it, and instructions

Select Add my skill and write down how you like the work done.