User guide
For everyone who works with Coworkers day to day.
Getting started
Sign in, find your way around the app, and learn what your abilities let you do.
- Signing inSign in with your work email, using a password or your company's own sign-in page, and sign out when you are done.
- Navigating the appWhat each item in the top navigation opens, and which ones you see depending on who you are.
- What your abilities meanHow abilities decide what you can see and do, with a plain-language guide to each one and to supervising a Coworker.
- Your time zoneHow Coworkers know your time zone, and how to choose a different one.
- My dataDownload a copy of your conversations, memories and account activity.
Coworkers
Hire a Coworker, move it through its phases, and manage its details and triggers.
- The Coworkers dashboardHow a Supervisor sees how a Coworker is doing: its metrics, its cohort and the feedback waiting for review.
- Hiring a CoworkerCreate a Coworker with the hiring wizard, or with a name and one sentence, depending on how your company has set up creation.
- Who can see which CoworkerWhich Coworkers you can see and open, depending on each Coworker's phase, and how Approve Coworkers works.
- Coworker detailsWhat the details page shows, and what its Supervisor can change: job description, expectations, Supervisor, instructions, model, Knowledge Bases, Team, Team access, secrets and connectors.
- Advancing a Coworker and retiring itMove a Coworker from Interview to Full-time with a recorded sign-off, or retire it.
- Proposed CoworkersHow a proposed Coworker waits for approval, and how approvers leave feedback, approve or retire it.
- Reviews and feedbackGive feedback on a Coworker's replies, and work through that feedback from the Supervisor dashboard.
- TriggersHave a Coworker run work on its own, on a schedule, once at a set time, or when another system calls a web address.
- Connectors for a CoworkerEnable a connector built for your organization on a Coworker, supply the secrets it uses, and disable it again.
- Coworker memoryThe short notes a Coworker keeps in mind in every conversation, which are shared with everyone or private to one person, and how to add, edit and remove them.
- SecretsStore the credentials Coworkers use, choose which ones a Coworker may use, and remove them again.
- Skills for a CoworkerWrite a skill that teaches your Coworker how you want a kind of task done, and give it the company-wide skills your administrators have written.
Chat
Chat with a Coworker, attach files, view its artifacts and computer, and rate replies.
- Chatting with a CoworkerStart a conversation with a Coworker, continue it, rename and archive threads, and see who can open it.
- Attaching files to a messageAttach images and documents to a chat message, and download files from a conversation.
- Giving feedback on a replyMark a Coworker's reply with a thumbs up or thumbs down and say what went wrong.
- The context paneUse the pane beside a conversation to see the Coworker's computer, the documents and files in play, and the artifacts it creates, including documents you write together.
- ArtifactsArtifacts are what a Coworker creates in a conversation: published reports, tools and dashboards, and documents you edit together. View them in the pane or full screen.
- Document artifactsWrite and edit a document artifact together with a Coworker in a conversation, comment on its text, share it with people, teams or your company, see who is in it, and go back to an earlier version.
- The Coworker's computer and terminalWatch the computer a Coworker is using in a conversation, take over its browser, and open a terminal on it.
- Connecting a Coworker to one of your systemsAsk a Coworker to work with a database, internal API or other system it cannot reach, and it builds a connector with you that your whole organization can use.
- The Artifacts pageFind every document and page you created, and every document others shared with you, in one place.
- Connecting your accountsConnect your own account on a system such as GitHub, and choose what your Coworkers may do with it.
- Export and import documentsSave a document as a Markdown, Word or PDF file, include its comments, and bring a Markdown or Word file in as a new document.
- Approving a requestAnswer a Coworker's request to use one of your connected accounts, from the chat or from Settings.
- Chat with a Coworker in Slack or Microsoft TeamsMessage a Coworker from Slack or Microsoft Teams, link your account the first time, approve its requests in the thread, and open the conversation in the app when needed.
- Chat accountsSee the Slack and Microsoft Teams accounts you have linked, unlink one, and choose where Coworker notifications arrive.
Knowledge bases
Create knowledge bases, add documents and web sources, and control who can use them.
- Browsing and searching Knowledge BasesFind Knowledge Bases, search across their documents, open one, and export it.
- Creating a Knowledge BaseAdd a Knowledge Base, choose its owner, and decide whether Coworkers can use it.
- Adding and editing documentsUpload Word, PDF, Excel, PowerPoint, image and text files, write a document by hand, replace a file, and delete a document.
- Editors and ownershipWho can manage a Knowledge Base, how to add editors, and how to remove a Knowledge Base.
- People-only Knowledge BasesKeep a Knowledge Base for people only, so Coworkers can never read or cite it.
- Team access and TeamLimit who can see a Knowledge Base to certain Teams, and set which Team it belongs to.
- Web sourcesHave a Knowledge Base collect pages from a website and keep them up to date.
- SharePoint sourcesHave a Knowledge Base collect the files and pages of a SharePoint site and keep them up to date.
Apps
Browse apps, create one, deploy your code, and move an app through its lifecycle.
- The Apps directoryBrowse the apps your company's Builders have shipped and see which ones you can reach.
- Creating an appRegister a new app, name its Builder, and get the repository you push code to.
- Deploying your codeRegister an SSH key, clone your app's repository and push to build and deploy.
- App detailsRead an app's description, lifecycle and Builder, manage Team access and issue the app's API key.
- Advancing and retiring an appMove an app through Interview, Internship, Apprenticeship and Full-time, or retire it.
- Opening an appOpen a running app from the directory or its details page, and return to the app's page.
Workflows
Start a workflow, follow its runs, and review, refine, approve or re-run what it makes.
- Starting a workflow runStart a workflow from the Workflows page, fill in its inputs form, and follow its runs.
- The review queueFind the workflow runs that are waiting for you, and open one to review it.
- Reviewing a runRead a run's inputs and outputs, ask the Coworker questions or changes, then approve, reject or re-run.
Work map
Map Work Centers, test and score them, and decide where a Coworker fits.
- The Intelligence MapSee every Work Center placed on a grid of Intelligence and Capability, with its classification and a ranked list of opportunities.
- The 2-hour mapping sessionRun the guided session that takes a group from mapping roles to naming the first Coworker, in four timed segments.
- Creating and editing a Work CenterDefine a Work Center with its inputs, processing, outputs and starting answers, and change it later.
- The Irreducibility TestClassify a Work Center by asking, separately for judgment and for execution, whether a person is structurally required.
- The Opportunity ScorecardScore a Work Center on seven dimensions to get a strong, moderate or defer read on whether to build a Coworker for it.
- Recording Shadow AIRecord the AI tools people already use for a Work Center so the map reflects reality, not policy.
- The quarterly refreshRedraw the map each quarter by answering three fixed questions and reviewing what changed since the last refresh.
Score and surveys
Read the WI Score, set its financial inputs, and run or answer the one-question survey.
- The WI Score pageRead your company's WI Score, its Amplification Factor (A), the band it sits in, the tier breakdown and the quarterly trend.
- Editing the financial inputsSet the Output and Workforce Cost that feed the WI Score.
- Launching a surveyLaunch the one-question WI Score survey, choose its audience and closing date, and share the link.
- Answering the WI Score surveyAnswer the one-question survey from the link you were sent, and learn what happens to your answer.
Organization
See reporting lines, units and roles, and bring an organization in from a file.
- The Organization pageSee who reports to whom, where Coworkers work and the units and roles in the company, and switch between lenses: Chart only, Potential, Planned, Realized, Adoption and Needs attention.
- Units, roles and role groupsAdd units and the roles in them, describe the work in a role, and read how the hours AI could free are worked out.
- Managing people on the Organization pageWho can move people, invite new people, give or remove the Coworker, Knowledge Base and App abilities, and reassign a Coworker's Supervisor from the chart, and how to choose your own manager.
- Import an organization from a fileBring units, roles, headcount and reporting lines into the Organization page from a people file, a roles file or a wi-org-import document, with a preview before anything changes.
- Planning a Coworker under a personPlan a Coworker under a person for the roles it would help, hire it from the plan, and draft a role's tasks from its job description.
- Reading what needs attentionWhat each warning on the Organization page means, how it is worked out, how warnings add up on a collapsed branch, and how to use the Needs attention lens.
- Adoption and time savedHow the Organization page's Realized and Adoption lenses work out how much time Coworkers saved and who is using them, and who sees figures by name.
Governance
See usage and cost, and track and run the monthly and quarterly reviews of Coworkers.
- The Governance pageFind usage and cost rollups, compensation, audit and value in one place, and see what each person can open.
- Usage and costSee what your Coworkers, Knowledge Bases, system jobs, teams and people have used and what it cost, for a month or a custom period.
- CompensationSet hourly rate bands and assign them to Teams and people, and see which band applies to each person.
- Working through feedbackWork through a Coworker's feedback and struggled interactions one by one and mark how each was resolved.
- The Audit logSee who did what across the organization, filter and inspect events, and export the record, with the Auditor ability.
- ValueSee the estimated hours and dollars your Coworkers save, as a range from conservative to optimistic, with coverage and the method behind the numbers.
- Where an answer's sources came fromLook up which Knowledge Base passages, documents and connectors a Coworker was shown while answering in chat, with the Auditor ability.