Skip to main content
Workspace provides a lightweight Linux environment for AI, enabling it to manipulate files and complete tasks such as editing files, creating presentations, and more. An assistant can be bound to one workspace.

​
Quick Start

1

Create a Workspace

  1. Go to Settings → Extension Management → Workspace to open the workspace management page.
  2. Tap the plus button in the bottom-right corner to create a new workspace and enter a name.
  3. Tap the newly created workspace card to enter its management page, then tap Install Rootfs to install the system files.
Workspace names must be in English.
2

Manage and Configure

On the workspace management page, you can:
  • Configure whether tools provided by the workspace require user approval before execution
  • Tap the Files tab to manage workspace files, including importing and exporting
  • Tap the icon in the top-right corner to open the terminal
3

Use in Chat

Go back to the chat page and tap the plus button in the chat bar. You will see a card for binding a workspace — tap it to bind to your target workspace.Once bound, the AI can operate within the workspace to complete various tasks when you give it instructions.

​
Glossary

TermDescription
WorkspaceAn isolated Linux environment provided by Rikka for AI. Each workspace runs independently with its own filesystem and packages.
TerminalA built-in command-line interface within the workspace where you can run Linux commands to manage files, install software, or debug issues.
RootfsShort for Root Filesystem — the base system files required for a workspace to run. Installing Rootfs is like installing an operating system for the workspace.

​
Installing Common Packages

Workspaces use the apt package manager by default. You can install packages manually via the terminal, or let the AI install what it needs during a task.
PackagePurpose
curlSend HTTP requests and download files
unzip / zipExtract and create ZIP archives
gitVersion control and repository cloning
jqParse and process JSON data
apt update && apt install -y curl unzip zip git jq
In most cases you don’t need to install packages manually — when you give the AI a task, it will automatically install any dependencies it needs.

​
File Import & Export

You can manage workspace files in two ways:
Open the workspace management page and tap the Files menu button at the bottom to switch to the file management view. From here you can:
  • Import files into the workspace
  • Export files from the workspace
  • Share files directly to other apps

​
Use Cases

Here are some example use cases for reference.

​
Clone a Repository and Edit Files

With a workspace bound, you can ask the AI to clone a Git repository and edit its files. For example, send a message like:
Clone https://github.com/user/repo and translate the README.md into Chinese
The AI will perform the following steps in the workspace:
  1. Install git (if not already installed)
  2. Clone the target repository into the workspace
  3. Read the contents of README.md
  4. Translate the content into Chinese and write it back to the file
Once complete, you can export the modified files through file management, or push to the remote repository.

​
Create a Presentation

  1. Go to Extension Management → Agent Skills and install the pptx skill.
  2. In the chat page, tap the plus button, go to extension management, and enable the skill.
  3. Send your request — for example, ask the AI to research a topic and create a presentation.
  4. The AI will progressively gather information and use the Python / Node.js environment in the workspace to generate the PPT file.
  5. Once complete, go to the workspace management page to export or share the generated PPT file.