File size: 2,024 Bytes
383cb38
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
---

name: atom-execute
description: Execute Atom command on-demand (temporary startup)
version: 1.0.0
author: Atom Team
tags: [atom, cli, execute, command]
maturity_level: AUTONOMOUS
governance:
  maturity_requirement: AUTONOMOUS
  reason: "On-demand execution requires full autonomy"
---


# Atom Command Executor

Execute Atom commands on-demand with temporary startup.

## Usage

Execute this skill to run Atom commands:
```

atom-os execute <command>

```

## Arguments

- `command`: Atom command to execute (required)

## Examples

Execute agent chat command:
```

atom-os execute "agent.chat('Hello, create a report')"

```

Execute workflow command:
```

atom-os execute "workflow.run('monthly_report')"

```

## Behavior

This command would:
1. Start Atom temporarily
2. Execute the specified command
3. Return the result
4. Shut down Atom

## Current Implementation Status

⚠️ **Command routing not yet implemented** - Use REST API instead.

## Alternative: REST API

For programmatic control, use these REST API endpoints:

### Start Atom as Service
```http

POST /api/agent/start

Content-Type: application/json



{

  "port": 8000,

  "host": "0.0.0.0"

}

```

### Execute Single Command
```http

POST /api/agent/execute

Content-Type: application/json



{

  "command": "agent.chat('Hello')",

  "agent_id": "agent-123"

}

```

### Stop Service
```http

POST /api/agent/stop

```

### Check Status
```http

GET /api/agent/status

```

## Notes

⚠️ **AUTONOMOUS maturity required** - On-demand execution requires full autonomy.

**Temporary Execution:** This command starts Atom only for the duration of command execution, then shuts down. For long-running service, use `atom-os daemon` instead.

**Future Implementation:** Command routing will be implemented in a future phase, allowing direct command execution via this CLI command.

## Documentation

See `atom-os config` for full API documentation and configuration details.