aboutsummaryrefslogtreecommitdiffstats
path: root/docs/argcfile.md
blob: c420977837eb992913895dd7cb34787c543f3b96 (plain) (blame)
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
# Argcfile

The [Argcfile.sh](https://github.com/sigoden/llm-functions/blob/main/Argcfile.sh) is a powerful Bash script designed to streamline the process of managing LLM functions and agents in your AIChat environment.

We encourage running `Argcfile.sh` using `argc`. Because `argc` provides better autocompletion, it can also be used without trouble on Windows.

Argcfile.sh is to argc what Makefile is to make.

https://github.com/user-attachments/assets/1acef548-4735-49c1-8f60-c4e0baf528de

## Usage

```sh
# -------- Help --------
argc -h                                     # Print help information
argc <command> -h                           # Print help information for <command>

# -------- Build --------
# Build all
argc build

# Build all tools
argc build@tool 
# Build specific tools
argc build@tool get_current_weather.sh execute_command.sh 

# Build all agents
argc build@agent 
# Build specific agents
argc build@agent coder todo

# -------- Check --------
# Check all
argc check

# Check all tools
argc check@tool 
# Check specific tools
argc check@tool get_current_weather.sh execute_command.sh 

# Check all agents
argc check@agent 
# Check specific agents
argc check@agent coder todo

# -------- Run --------
# Run tool
argc run@tool get_current_weather.sh '{"location":"London"}'
# Run agent tool
argc run@agent todo add_todo '{"desc":"Watch a movie"}'

# -------- Test --------
# Test all
argc test
# Test tools
argc test@tool
# Test agents
argc test@agent

# -------- Clean --------
# Clean all
argc clean
# Clean tools
argc clean@tool
# Clean agents
argc clean@agent

# -------- Link --------
argc link-web-search web_search_tavily.sh 
argc link-code-interpreter execute_py_code.py 

# -------- Misc --------
# Install this repo to aichat functions_dir 
argc install                      
# Displays version information for required tools
argc version
```

## MCP Usage

```sh
# Start/restart the mcp bridge server
argc mcp start

# Stop the mcp bridge server
argc mcp stop

# Run the mcp tool
argc mcp run@tool fs_read_file '{"path":"/tmp/file1"}'

# Show the logs
argc mcp logs
```