A project folder on your computer can belong to a project in AIUS Light. AIUS Light then keeps the folder’s conversations, so you can read them in the browser and continue them on any of your computers. The folder’s files stay on your computer: they are not copied to AIUS Light, and files in AIUS Light are not copied to the folder.

​
The first start in a folder

The first time you start AIUS in a folder, it links the folder to a project in your personal organisation by itself, and says which, naming the organisation:
  • A project with the folder’s name (letter case and spacing aside). So a folder with the same name on another computer joins the same project, and brings its conversations.
  • Otherwise a new project, named after the folder, or after the project name AIUS already had for it on this computer.
AIUS never reaches into a team organisation by itself. It asks first, and does nothing until you answer, when the folder would go to a team: a team project has the folder’s name, your default organisation is a team one (where others would see a new project), or another folder on this computer is already linked to the project with that name. You can link it to that project, create a project in your default or personal organisation, or keep the folder on this computer. The first folder linked on a computer explains what AIUS Light keeps and how a report gets to the web. After that, the home screen shows the folder’s project as AIUS Light: project; click it to open the project in your browser. To publish your analysis, ask AIUS to publish a report, or type /share to publish the conversation; either goes to the folder’s project. To link the folder to another project, create one with another name, keep the folder on this computer or unlink it, run /projects. An unlinked folder stays on this computer until you link it again.

​
When you ask without a project

Ask for an analysis, a demo or a dashboard in a folder that is not linked to a project, and AIUS starts the project by itself, without asking: it creates it in your default organisation and links the folder to it. When AIUS runs in your home folder, or a folder directly in it that holds everything (Desktop, Documents, Downloads and the like), it never links that folder or looks through it: it makes a new folder for the project in ~/AIUS, named after it, works there, and publishes the report to the project when it is done. Coding work and small questions start no project. You can still link a folder yourself with /projects.

​
What AIUS Light keeps

  • Conversations: every session in a linked folder, as it is written, including what AIUS reads from your files and the output of the commands it runs. A computer where you link a folder to the same project brings them in, and you can continue any of them there. See Your computers.
  • Files you publish: reports, and files you or AIUS publish to the project on purpose. Your folder’s own files are never uploaded.

​
Projects made in AIUS Light

Type /projects to see the folder’s project and every project you can work in, including ones created in AIUS Light. Choosing a project links the folder to it and brings in its conversations. From the same dialog you can open the project in AIUS Light or unlink the folder. Unlinking keeps every file where it is. The link is stored in the folder, in .aius/light.json, so it can travel with the folder. If the project is deleted, or you are removed from its organisation, AIUS stops sending the folder’s conversations there and asks you once what to do, with the choices ready: create the project again, link a project with its name, choose another project, or keep the folder on this computer. It asks when AIUS starts in the folder, or as soon as it notices while you work. The folder’s files and conversations stay on your computer whatever you choose.

​
When AIUS Light can’t be reached

You can keep working while AIUS Light is down or unreachable: AIUS says so once. Publishing and keeping conversations come back by themselves when it answers again, and a folder that was not linked yet is linked then, without restarting AIUS.

​
Opening a project from anywhere

Type /open, or run aius open in any shell, to list every project and conversation you have. Choose one and AIUS starts again in its folder, on that conversation. You can also name it directly:
  • If the project has no folder on this computer yet, AIUS makes one in ~/AIUS, named after the project, and brings in its conversations.
  • If you deleted the folder, AIUS makes it again where it was, with your conversations from AIUS Light. Files are not brought back: they live only on the computers that have them.
A folder you linked on aius.co links to the same project here the first time you start AIUS in it. See Coming from aius.co.

​
Sessions already on this computer

Sessions kept in ~/.local/share/aius appear in /sessions for the folder they were started in, the first time you start AIUS there. They are copied, and the originals are never changed. A copy you delete stays deleted. In a folder linked to a project, AIUS Light also keeps your sessions as the project’s conversations, so you can read them in the browser and continue them on another computer linked to the same project. Only you can see them. Deleting one there deletes it in AIUS Light and on your other computers too. See Your computers.