MAYA DOCS
Maya beginner guide
If this is your first time using Maya, start by connecting a local assistant. After that, create a goal or task, track progress, handle approvals, and collect outputs.
Start here
Learn 4 words first
Local assistant: A runner installed on your machine or server. Connect it first, then create goals or tasks.
Goal: The outcome you want, such as a report, course outline, or project analysis. Use a goal when the work has more than one step.
Task: One executable unit in the queue. Each task has status, comments, execution records, and outputs.
Artifact: The final file or result from a task, such as Markdown, DOCX, slides, or spreadsheets. Look on the task page first.
After setup, choose how to start
After setup, choose how to start
Step 1: Connect local assistant: Connect your machine or server first. Tasks, project folders, local outputs, and local tools depend on this step.
Step 2: Create a goal: Reports, courses, project analysis, and sales material usually start as goals so Maya can split them into tasks.
Or: create one task: For a concrete one-step request, click New Task and send it to the queue.
- 1Open Local Assistant and connect the machine or server that will run your work.
- 2After the assistant is online, decide whether this is multi-step work. If yes, create a goal; if not, create a task directly.
- 3Describe the result clearly: deliverable, audience, limits, and reference material.
- 4Use the task page to track queue state, running state, approvals, failures, and outputs.
- 5Download final artifacts from the task page, or find them in the project folder when a project directory is bound.
Step 1
Connect a local assistant before starting
Maya needs to know which machine or server will run the work. Once connected, tasks can use local files, project folders, and local tools reliably.
- 1Open Local Assistant and start the runner on the target machine.
- 2Return to Maya and confirm the machine is online.
- 3Bind a project directory if the work revolves around a folder.
- 4Choose this local assistant when creating goals or tasks.
- You get an online local assistant. Maya manages queueing and state while that machine handles files, documents, and tools.
Step 2
Create a goal for complex work
When you know the desired outcome but not every step, a goal turns that outcome into a trackable task chain.
- 1Open Goals and create a goal with the final result in the title.
- 2Add context: audience, format, references, and constraints.
- 3Review the proposed task plan before execution.
- 4Use the goal detail page to watch progress, risks, blockers, and outputs.
- You get a goal page with task breakdown, progress, blockers, and final artifacts.
Optional path
Create a task for one-step work
When you already know the exact action, send a task straight to the queue.
- 1Click New Task and describe the result, not just a vague topic.
- 2Attach input material or link a project if needed.
- 3Choose the connected local assistant as the execution environment.
- 4Open the task detail page to see whether it is queued, running, waiting, failed, or done.
- You get one task page where status, comments, execution records, approvals, and artifacts live together.
What you get
How to decide
First-time setup: connect a local assistant and confirm the execution machine is online.
Goal or task: use a goal for multi-step work; use a task for one step.
Task not moving: check the task detail status first.