> For the complete documentation index, see [llms.txt](https://docs.aios.foundation/aios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aios.foundation/aios-docs/getting-started/quickstart/use-terminal.md).

# Use Terminal

### Run agents and tools in the unix-like terminal

List agents from agenthub

```bash
list-agenthub-agents
```

List agents from local

```bash
list-local-agents
```

Download agents

```bash
download-agent \
    --agent_author <agent_author> \
    --agent_name <agent_name> \
    --agent_version <agent_version> \
    --agenthub_url <agenthub_url>
```

Upload agent

```bash
upload-agents \
    --agent_path <agent_path> \
    --agenthub_url <agenthub_url>
```

List tools from toolhub

```bash
list-toolhub-tools
```

List tools from local

```bash
list-local-tools
```

Download tool

```bash
download-tool \
    --tool_author <tool_author> \
    --tool_name <tool_name> \
    --tool_version <tool_version> \
    --toolhub_url <toolhub_url>
```

Upload tool

```bash
upload-tool \
    --tool_path <tool_path> \
    --toolhub_url <toolhub_url>
```

### Interact with AIOS terminal UI

Before running the AIOS terminal, please make sure you have read the instructions in [AIOS](https://github.com/agiresearch/AIOS) to set up the environment and launch the AIOS kernel.&#x20;

And you need to create a folder to put the files you want to manage, the default folder is `./root`

After that, you can run the following command to start the AIOS terminal.

```
python scripts/run_terminal.py
```

When you successfully enter the system, the interface is as follows:

<figure><img src="/files/uT09JQVIGUErmzstSk4J" alt=""><figcaption><p>Example of Launched AIOS terminal</p></figcaption></figure>

Then you can start interacting with the AIOS terminal by typing natural language commands.&#x20;

For instructions of how to use commands, refer to <https://github.com/agiresearch/AIOS-LSFS>.&#x20;
